Attribute | Type | Description | Req. | RTExp |
accesskey | String |
The accesskey attribute can be used to specify a shortcut
key for the <LABEL> (activated by pressing Alt and
the accesskey togther).
| |
|
align | AlignmentType |
Specifies the horizontal alignment of the element.
-
left
=
left alignment
-
right
=
right alignment
-
center
=
center alignment
| |
|
colspan | Integer |
Specifies the column span of a form element
within a multi column form
| |
|
height | String |
Sets the height of the form element. The height
may be specified in absolute or percent terms.
Annotation:
See HTML documentation for the attribute height.
| |
|
help | String |
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 Key | Description | Default |
fw.help.onclick | An optional onclick script handler. The handler can include
a {0} placeholder for the help id | - |
fw.help.target | Specifies the target where to open the hyperlink | _blank |
fw.help.tooltip | A tooltip for the hyperlink | context help |
Annotation:
A jump screen of the Help system must be specified.
| |
|
imageref | String |
Pointer to an element of the Imagemap of the form.
The image is drawn before the label of the element.
| |
|
join | Boolean |
Indicates that two adjacent form elements should be
joined together
| |
|
label | String |
The label of the form element.
| |
|
labeltooltip | String |
Tooltip on for the label of the form element.
| |
|
permission | ACL |
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
| |
|
required | boolean |
Indicates whether the form element involved is a mandatory input.
Mandatory fields are displayed highlighted for the user's convenience.
| |
|
valign | AlignmentType |
Specifies the vertical alignment of the element.
-
top
=
top alignment
-
bottom
=
bottom alignment
-
center
=
center alignment
| |
|
width | String |
Sets the width of the form element. The width
may be specified in absolute or percent terms.
Annotation:
See HTML documentation for the attribute width.
| |
|