Die Common-Controls Tag Bibliothek

empty

String

Gibt das Label für einen zusätzlichen Empty-Eintrag an. Dabei Handelt es sich um einen Eintrag mit einem leeren Schlüssel. Dieser ist immer dann erforderlich, wenn auch der Null-Wert in der Liste angeboten werden soll.

filter

Boolean

Mit dem filter-Attribut kann die automatische HTML-Konvertierung des Elementes aktiviert bzw. deaktiviert werden.

true = Die HTML Konvertierung ist aktiv. So wird beispielsweise das "<" Zeichen als "<" codiert. HTML Code wird damit nicht ausgeführt.
false = Die HTML Konvertierung ist abgeschaltet. HTML Code wird demzufolge direkt in die Seite eingesetzt und somit ausgeführt.

imagemap

String

Gibt den Namen einer Imagemap an, welche im Request abgelegt sein muss. Die Werte welche das Options- Schlüssel Element liefert werden auf die Einträge dieser ImageMap abgebildet. Die Abbildung erfolgt anhand des regulären Ausdrucks welcher jedem Eintrag der ImageMap zugeordnet ist.

Anmerkung: Unter dem Namen muss eine ImageMap im Request abgelegt sein.

keyProperty

String

Gibt den Namen des Properties an welches den Schlüssel der Option liefert.

Der Datentyp des Properties muss mit dem Datentyp des umschliessenden select-Tags kompatibel sein

Anmerkung: Gültiger Java Bezeichner für ein Property welches von den Elementen der Aufzählung implementiert werden muss.

labelProperty

String

Gibt den Namen des Properties an, welches den Anzeigetext der Option liefert.

Die Zeichenkette wird zuerst HTML-codiert.

Anmerkung: Gültiger Java Bezeichner für ein Property welches von den Elementen der Aufzählung implementiert werden muss.

localize

Boolean

Wird für dieses Flag true angegeben, so interpretiert das Framework alle Labels als Ressourcen Schlüssel und lokalisiert diese.
Bei false werden die Labels als String Literale direkt ausgegeben.

Das "empty" label wird immer als Ressourcen Schlüssel interpretiert und lokalisiert!

maxlength

Integer

Gibt die maximale Zeichenzahl für die Texte der dargestellten Optionselemente an. Weitere Zeichen werden abgeschnitten und als "..." Zeichenfolge dargestellt.

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.

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.

root

Boolean

Mit diesem Attribut wird angegeben ob der Wurzelknoten einer TreeNodeDataModel basierten Optionsliste angezeigt werden soll.

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.

tooltipProperty verfügbar ab Version 1.6.033

String

Gibt den Namen des Properties an, welches den Tooltip Text der Option liefert.

Die Zeichenkette wird zuerst HTML-codiert.

Anmerkung: Gültiger Java Bezeichner für ein Property welches von den Elementen der Aufzählung implementiert werden muss.

`<base:options>`

[ Syntax ]

Standard Syntax

[ Attribute ]

[ Beispiel ]

Attribut	Typ	Beschreibung	Pflicht	RTExp
empty	String	Gibt das Label für einen zusätzlichen Empty-Eintrag an. Dabei Handelt es sich um einen Eintrag mit einem leeren Schlüssel. Dieser ist immer dann erforderlich, wenn auch der Null-Wert in der Liste angeboten werden soll.
filter	Boolean	Mit dem filter-Attribut kann die automatische HTML-Konvertierung des Elementes aktiviert bzw. deaktiviert werden. `true` = Die HTML Konvertierung ist aktiv. So wird beispielsweise das "<" Zeichen als "<" codiert. HTML Code wird damit nicht ausgeführt. `false` = Die HTML Konvertierung ist abgeschaltet. HTML Code wird demzufolge direkt in die Seite eingesetzt und somit ausgeführt.
imagemap	String	Gibt den Namen einer Imagemap an, welche im Request abgelegt sein muss. Die Werte welche das Options- Schlüssel Element liefert werden auf die Einträge dieser ImageMap abgebildet. Die Abbildung erfolgt anhand des regulären Ausdrucks welcher jedem Eintrag der ImageMap zugeordnet ist. Anmerkung: Unter dem Namen muss eine ImageMap im Request abgelegt sein.
keyProperty	String	Gibt den Namen des Properties an welches den Schlüssel der Option liefert. Der Datentyp des Properties muss mit dem Datentyp des umschliessenden select-Tags kompatibel sein Anmerkung: Gültiger Java Bezeichner für ein Property welches von den Elementen der Aufzählung implementiert werden muss.
labelProperty	String	Gibt den Namen des Properties an, welches den Anzeigetext der Option liefert. Die Zeichenkette wird zuerst HTML-codiert. Anmerkung: Gültiger Java Bezeichner für ein Property welches von den Elementen der Aufzählung implementiert werden muss.
localize	Boolean	Wird für dieses Flag `true` angegeben, so interpretiert das Framework alle Labels als Ressourcen Schlüssel und lokalisiert diese. Bei `false` werden die Labels als String Literale direkt ausgegeben. Das "empty" label wird immer als Ressourcen Schlüssel interpretiert und lokalisiert!
maxlength	Integer	Gibt die maximale Zeichenzahl für die Texte der dargestellten Optionselemente an. Weitere Zeichen werden abgeschnitten und als "..." Zeichenfolge dargestellt.
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.
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.
root	Boolean	Mit diesem Attribut wird angegeben ob der Wurzelknoten einer TreeNodeDataModel basierten Optionsliste angezeigt werden soll.
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.
tooltipProperty	String	Gibt den Namen des Properties an, welches den Tooltip Text der Option liefert. Die Zeichenkette wird zuerst HTML-codiert. Anmerkung: Gültiger Java Bezeichner für ein Property welches von den Elementen der Aufzählung implementiert werden muss.