| Attribut | Typ | Beschreibung | Pflicht | RTExp | ||||||||||||
| align | AlignmentType |
Gibt die horizontale Ausrichtung in der Formularelement
Zelle an
|
 |
|||||||||||||
| colspan | Integer | Gibt bei einem mehrspaltigen Formular die Anzahl der Spalten an, welche von dem Formularelement belegt werden sollen. |
|
|||||||||||||
expandProperty | String |
Gibt den Namen eines Properties an, welches das Element
auf oder zuklapt. Der von dem Property zurückgelieferte Wert
muß auf einen booleschen Wert abgebildet werden können.
Anmerkung: Gültiger Java Bezeichner. Die Form bean muß eine passende Property-Getter Methode implementieren. |
|
|||||||||||||
| height | String |
Setzt die Höhe des Kontrollelmentes. Die Höhe kann absolut
oder prozentual angegeben werden.
Es hängt vom jeweiligen Kontrollelement Painter ab, ob diese Information ausgewertet wird Siehe HTML-Dokumentation |
|
|||||||||||||
| help | String |
Weist dem Kontrollelement einen Hilfe Bezeichner zu. Es wird
ein Hilfe Symbol neben dem Kontrollelement angezeigt,
welches bei einem Klick einen onHelp Event erzeugt.
Der Bezeichner wird dabei als Parameter übergeben und kann somit
zur Anzeige von kontextabhängigen Hilfetexten benutzt werden.
Das eigentliche Hilfesystem ist nicht Teil des Common-Controls Frameworkes, der onHelp Event kann jedoch zur Verankerung verwendet werden. Für die Erzeugung des Hyperlinks zum Aufruf der Hilfe sind einige vordefinierte Framework Ressourcen zuständig. Diese kann der Anwendungsentwickler global oder auf Kontrollelement Ebene verändern:
Anmerkung: Der Hilfe Bezeichner wird von dem Common-Controls Framework an das Hilfesystem weitergegeben. Die Syntax und Semantik hängt daher von dem verwendeten Hilfesystem ab. |
|
|||||||||||||
| imageref | String |
Verweis auf ein Element der ImageMap des Formulars. Das Image
wird vor dem Label des Formularelementes gezeichnet.
Die ImageMap wird im umschliessenden Formular Tag mit Hilfe des imagemap Attributes gesetzt |
|
|||||||||||||
| join | Boolean | Mit diesem Flag wird angegeben ob das Vormularelement mit dem vorhergehenden Element verbunden werden soll. Zwischen verbundenen Formularelementen werden keine Trennungslinien gezeichnet. |
|
|||||||||||||
| noframe | Boolean | Mit Hilfe dieses Attributes kann der Rahmen des Kontrollelementes unterdrückt werden. Eventuell notwendige Schaltflächen werden rechts über dem Kontrollelement angezeigt (abhängig von der verwendeten PainterFactory. |
|
|||||||||||||
| permission | ACL |
Mit diesem Attribut kann der Zugriff auf das Element
beschränkt werden.
Berechtigungen werden über das Principal Objekt in der Benutzer Session geprüft. Das Principal Objekt wird mit der Methode SecurityUtil.registerPrincipal() in der Session registriert. Es wird vom Anwendungsentwickler durch Implementierung des Principal Interfaces zur Verfügung gestellt. Somit lassen sich sehr einfach beliebige Berechtigungssysteme mit dem Framework verbinden. Berechtigungen werden immer in Form einer Access Control List (ACL) angegeben. Dabei handelt es sich um einen Ausdruck dessen Elemente Einzelberechtigungen sind. Das Framweork unterstützt die folgenden Berechtigungstypen, welche jedoch vom Anwendungsentwickler beliebig erweitert werden können:
Zur Formulierung der Ausdrücke kann die folgende Syntax verwendet werden:
PERMISSION_PREFIX
: '#' | '$'
AND_OP
: 'and' | '&' | '*'
XOR_OP
: 'xor' | '^'
OR_OP
: 'or' | '|' | '+'
UNARY_OP
: '~' | '!'
permission
: PERMISSION_PREFIX IDENTIFIER
primary_expr
: permission
| '(' expr_list ')'
unary_expr
: primary_expr
| UNARY_OP primary_expr
logical_and_expr
: unary_expr
| logical_and_expr AND_OP unary_expr
logical_xor_expr
: logical_and_expr
| logical_or_expr XOR_OP logical_and_expr
logical_or_expr
: logical_xor_expr
| logical_or_expr OR_OP logical_xor_expr
expr_list
: logical_or_expr
| expr_list ';' logical_or_expr
| expr_list ',' logical_or_expr
Access Control Listen werden mit der statischen Methode AccessControlList.parse() eingelesen. Der Parser verwendet wiederum die statische Methode PermissionFactory.parse() um die einzelnen Permissions zu lesen. Der Anwendungsentwickler kann über die PermissionFactory eigene von Permission abgeleitete Klassen registrieren und so den Sprachumfang der ACL erweitern. |
|
|||||||||||||
| title | String | Die Überschrift des Abschnittes |
|
|||||||||||||
| valign | AlignmentType |
Gibt die vertikale Ausrichtung in der Formularelement
Zelle an
|
|
|||||||||||||
| width | String |
Setzt die Breite des Kontrollelmentes. Die Breite kann
absolut oder prozentual angegeben werden.
Siehe HTML-Dokumentation |
|