<forms:radiogroup>
com.cc.framework.taglib.forms.FormElementContainerTag
verwendet werden. Beispiele hierfür sind <forms:form> und
<forms:section>
Attribut | Typ | Beschreibung | Pflicht | RTExp | ||||||||||||
accesskey | String | Der Tastatur-Shortcut (darf nur ein Zeichen sein), mit dem der Browser den Fokus auf ein Eingabeelement übertragen kann. |
![]() |
|||||||||||||
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. |
![]() |
|||||||||||||
columns | Boolean | Gibt an wieviele Radio-Buttons nebeneinder dargestellt werden sollen. |
![]() |
|||||||||||||
description | String | Der Beschreibungstext |
![]() |
|||||||||||||
disabled | Boolean | Über dieses Attribut kann das Kontrollelement deaktiviert werden. Es nimmt dann keine Benutzereingaben entgegen und erzeugt keine Kontrollelement Ereignisse. |
![]() |
|||||||||||||
disableProperty | String |
Gibt den Namen eines Properties an, mit welchem jeder
einzelne Radiobutton disabled werden kann. Das Property
muß einen Boolean Datentyp zurückliefern.
Das Property muß von der verwendeten Optionsliste implementiert werden. Anmerkung: Gültiger Java Bezeichner. Die Optionselemente müssen eine passende Property-Getter Methode implementieren. |
![]() |
|||||||||||||
groupingProperty | String |
Gibt den Namen eines Properties an, welches für
die Gruppierung der Radiobuttons verwendet wird. Wenn
sich der von dem Property zurückgelieferte Wert
ändert, dann wird in der Radio Gruppe ein
Zeilenumbruch eingefügt.
Das Property muß von der verwendeten Optionsliste implementiert werden. Anmerkung: Gültiger Java Bezeichner. Die Optionselemente müssen 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. |
![]() |
|||||||||||||
id | String |
Weist dem Kontrollelement einen eindeutigen Bezeichner zu.
Im Tag Body wird daraufhin eine Java Variable angelegt, auf
welche in Java Scriptlets zugegriffen werden kann.
Diese Variable verweist auf die Kontrollelement Instanz.
Dieses Attribut wird meist in Verbindung mit dem type Attribut verwendet Anmerkung: Da zur JSP Compile Zeit eine Java Variable mit diesem Bezeichner angelegt wird, muss hier ein String Literal (und keine Expression!) angegeben werden! Der Bezeichner muss den Regeln für gültiger Java Bezeichner folgen. |
![]() |
|||||||||||||
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. |
![]() |
|||||||||||||
label | String | Das Label des Formularelementes. |
![]() |
|||||||||||||
labeltooltip | String | Tooltip auf dem Label des Formularelementes. |
![]() |
|||||||||||||
name | String |
Gibt den Namen der Java-Bean an. Die Java-Bean muss im
angegebenen Scope (siehe scope-Attribut) 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. |
![]() |
|||||||||||||
onblur | String |
Fires when the object loses the input focus.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onchange | String |
Fires when the contents of the object or selection have changed.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onclick | String |
Fires when the user clicks the left mouse button on the object.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
oncontextmenu | String |
Fires when the user clicks the right mouse button in the client
area, opening the context menu.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
ondblclick | String |
Fires when the user double-clicks the object.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onfocus | String |
Fires when the object receives focus.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onkeydown | String |
Fires when the user presses a key.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onkeypress | String |
Fires when the user presses an alphanumeric key.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onkeyup | String |
Fires when the user releases a key.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onmousedown | String |
Fires when the user clicks the object with either mouse button.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onmousemove | String |
Fires when the user moves the mouse over the object.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onmouseout | String |
Fires when the user moves the mouse pointer outside the boundaries
of the object.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onmouseover | String |
Fires when the user moves the mouse pointer into the object.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
onmouseup | String |
Fires when the user releases a mouse button while the mouse is
over the object.
Anmerkung: JavaScript Code |
![]() |
|||||||||||||
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, welches die Daten für das
Formularelement liefert.
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. |
![]() |
|||||||||||||
required | Boolean | Gibt an, ob es sich bei dem Formularelement um eine Pflichtangabe handelt. Pflichtfelder werden für den Anwender visuell hervorgehoben dargestellt. |
![]() |
|||||||||||||
scope | HttpScope |
Dieses Attribut gibt den Scope an, in welchem die Java-Bean
mit den eigentlichen Anzeigedaten zu finden ist.
|
![]() |
|||||||||||||
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. |
![]() |
|||||||||||||
tabindex | Integer | Tabulator Index für dieses Element. |
![]() |
|||||||||||||
tooltip | String | Ein Kurzer Hinweistext, welcher angezeigt wird, wenn der Anwender den Mauszeiger über das Element bewegt. |
![]() |
|||||||||||||
valign | AlignmentType |
Gibt die vertikale Ausrichtung in der Formularelement
Zelle an
|
![]() |
|||||||||||||
value | String | Der Wert des Kontrollelementes kann mit diesem Attribut auch direkt als Litteral angegeben werden. |
![]() |
|||||||||||||
width | String |
Setzt die Breite des Kontrollelmentes. Die Breite kann
absolut oder prozentual angegeben werden.
Siehe HTML-Dokumentation |
![]() |