The Common-Controls Tag Library

<ctrl:hidden>

This tag creates a hidden field. The value for the hidden field can be set:

Body content: JSP
Tag class: HiddenTag
 

[ Syntax ]

Standard Syntax
<ctrl:hidden
[ converter = "Java class or Converter Id" ]
[ filter = "boolean" ]
[ height = "String" ]
[ help = "String" ]
[ id = "String" ]
[ name = "String" ]
[ permission = "ACL" ]
[ property = "String" ]
[ styleId = "String" ]
[ tooltip = "String" ]
[ value = "String" ]
[ width = "String" ]
[ write = "boolean" ]
>
...Body Content...

</ctrl:hidden>
 

[ Attributes ]

AttributeTypeDescriptionReq.RTExp
converterJava class or Converter Id Specifies the Converter which should be used to convert the data for the control. If the attribute is not set the framework will use a default converter which matches the controls data type (ConverterRegistry.lookup()).

A converter can be specified in different ways:

  • The public Converter Id is set.
  • Or a full qualified Java class name for the converter is specified. The class must implement the interface Converter

Annotation: The class must to implement the interface Converter!

 
filterboolean The automatic HTML coding of the column contents can be activated or disabled with the filter-attribute.  
heightString Sets the height of the control element. The height may be specified in absolute or percent terms.

See the HTML documentation

 
helpString Allows to assign a help id for the element. If set, a help symbol will be displayed beside the element, which will generate an onHelp event if the icon is clicked. The id can be used to display a special page of the help system. The help system is not part of the Common-Controls Framework.

To generate the hyperlink some default framework resources where used:
Resource KeyDescriptionDefault
fw.help.onclickAn optional onclick script handler. The handler can include a {0} placeholder for the help id-
fw.help.targetSpecifies the target where to open the hyperlink_blank
fw.help.tooltipA tooltip for the hyperlinkcontext help

Annotation: A jump screen of the Help system must be specified.

 
idString The name of a page scope JSP bean that will contain the current element. Using the given Id, the variable can be accessed in scripting expressions in the tag Body. The id mus be a string lteral because the JSP compiler generates a variable withthis name at compile time

Annotation: A valid Java identifier must be given.

 
nameString Specifies the name of the Java-Bean. The Java-Bean must be stored in the given scope.

When the tag is surrounded by a Struts <html:form> tag, no Bean Name need be specified. In this case, the Java-Bean is drawn via a property of the Struts Form Bean.

Annotation: A valid Java identifier must be given.

 
permissionACL With this attribute, access to the element can be restricted.

Authorizations are checked using the com.cc.framework.security.Principal object in the user session. The principal object is registered in the session with the method com.cc.framework.security.SecurityUtil#registerPrincipal(HttpSession, Principal). It is made available by the application developer by implementing the principal interface. In this manner, any authorization system can be very easily connected within the framework.

Authorizations are always specified in the form of an Access Control List (ACL). What is involved here is a semicolon-delimited list with individual authorizations. The framweork supports the following authorization types, which, however, can be expanded at will by the application developer:

Literal
true|false -> com.cc.framework.security.StaticPermission
Role
#rolename -> com.cc.framework.security.RoleBasedPermission
Function
$functionname -> com.cc.framework.security.FunctionBasedPermission

 
propertyString Specifies the name of the property using which the Java-Bean is to be accessed. This is generally only necessary when the Java-Bean is associated with a Struts Form Bean.

Annotation: A valid Java identifier must be given.

 
styleIdString The HTML-id attribute of the element can be specified with this attribute.

Annotation: See HTML documentation for the Attribute id.

 
tooltipString A short descriptive text that is displayed when the user moves the mouse over the element.

The character string is HTML-encoded before outputting.

 
valueString This attribute sets the initial displayed value of the field if it displays a textual or numerical value.

Annotation: See HTML documentation for the attribute value.

 
widthString Sets the width of the control element. The height may be specified in absolute or percent terms.

See the HTML documentation

 
writeboolean Specifies if the value of the field also should be outputed as a string literal.  

[ Example ]

Creates a hidden field


<%@ taglib uri="http://www.common-controls.com/cc/tags-ctrl"    prefix="ctrl" %>

<ctrl:hidden  label="Name"  property="name"/>