| Attribut | Typ | Beschreibung | Pflicht | RTExp |
| caption | String |
Die Hauptüberschrift des Formulars.
Überschrift und Detail können auch gemeinsam in der Form "title - detail" angegeben werden. |
 |
|
| detail | String | Die Detail Überschrift des Formulars. |
|
|
| filter | Boolean |
Mit dem filter-Attribut kann die automatische
HTML-Konvertierung des Elementes aktiviert bzw. deaktiviert werden.
|
|
|
| formid | String |
Die eindeutige Identifikation des Formulars. Sie wird
als Hiddenfield mit dem Namen formid in des
Formular geschrieben und ist somit nach dem absenden des Formulars
auf dem Server wieder verfügbar.
Das Framework kann über die |
|
|
| hideButtons | Stringliste |
Mit diesem Attribut kann eine Liste von Schaltflächen
ausgeblendet werden. Die auszublendenden Schaltflächen
werden in einer Semikolon getrennten Liste angegeben.
Anmerkung: Mit Semikolon getrennte Liste von Schaltflächen Namen. Die Namen müssen dabei einer der ControlButton.getName() Konstanten entsprechen! |
 |
|
| name | String |
Gibt den Namen der Java-Bean - eine Instanz der Klasse
Control.
Die Java-Bean muss im angegebenen Scope abgelegt sein.
Wenn das Tag von einem Struts <html:form> Tag umschlossen ist, dann muss kein Bean Name angegeben werden. In diesem Fall wird die Java-Bean über ein Property der Struts Formular Bean gezogen. Anmerkung: Es muss ein gültiger Java Bezeichner angegeben werden. |
|
|
| 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. |
|
|
| property | String |
Gibt den Namen des Properties an, über welchen auf
die Java-Bean zugegriffen werden soll. Dies ist in
der Regel nur dann notwendig, wenn die Java-Bean
mit einer Struts Formular Bean assoziiert ist.
Anmerkung: Es muss ein gültiger Java Bezeichner angegeben werden. |
|
|
| severity | Severity |
Gibt die Fehlerklasse des Meldungs Formulars an.
Mit der Fehlerklasse wird das Erscheinungsbild des
Formulars beeinflusst.
Filterung: Die Kollektion der Meldungstexte wird auf die angegebene Fehlerklasse gefiltert. Wird als Fehlerklasse none angegeben, so erfolgt keine Filterung. Besonderheit für Struts: Wird der name und das property Attribut nicht angegeben, so zeigt das Formular eine der beiden Meldungstext Kollektionen des Struts Frameworks an. Das severity Attribut legt in diesem Fall fest welche Kollektion angezeigt werden soll ("error" oder "information")
|
|
|
| style | String |
Über dieses Attribut kann direkt ein HTML-style
Attribut angegeben werden.
Anmerkung: Siehe HTML Dokumentation für das Attribut style. |
|
|
| styleClass | String |
Über dieses Attribut kann direkt ein HTML-class
Attribut angegeben werden.
Anmerkung: Siehe HTML Dokumentation für das Attribut class. |
|
|
| styleId | String |
Über dieses Attribut kann direkt ein HTML-id
Attribut angegeben werden.
Anmerkung: Siehe HTML Dokumentation für das Attribut id. |
|
|
| width | String |
Gibt die Breite des Formularfensters an.
Die Breite kann absolut oder prozentual angegeben werden.
Siehe HTML-Dokumentation |
|