Die Common-Controls Tag Bibliothek

<base:option>

Das Tag erzeugt ein einzelnes HTML-option element für ein <html:select>- bzw. <forms:select>-Tag. Der Selektions Status des Option Elementes wird dabei von dem umschliessenden Tag festgelegt.

Body content: JSP
Tag class: OptionTag
 

[ Syntax ]

Standard Syntax
<base:option
key = "String"
[ disabled = "Boolean" ]
[ filter = "Boolean" ]
[ label = "String" ]
[ maxlength = "Integer" ]
[ style = "String" ]
[ styleClass = "String" ]
[ styleId = "String" ]
>
...Body Content...

</base:option>
 

[ Attribute ]

AttributTypBeschreibungPflichtRTExp
disabledBoolean Über dieses Attribut kann das Kontrollelement deaktiviert werden. Es nimmt dann keine Benutzereingaben entgegen und erzeugt keine Kontrollelement Ereignisse.  
filterBoolean 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 "&lt;" 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.
 
keyString Gibt den Schlüssel des Optionselementes an.
labelString Gibt den Text oder Ressourcen Schlüssel des Options Elementes an. Der Text kann auch innerhalb des TagBody angegeben werden.

Die Zeichenkette wird zuerst HTML-codiert.

 
maxlengthInteger Gibt die maximale Zeichenzahl für das Label des Optionselementes an. Weitere Zeichen werden abgeschnitten und als "..." Zeichenfolge dargestellt.  
styleString Über dieses Attribut kann direkt ein HTML-style Attribut angegeben werden.

Anmerkung: Siehe HTML Dokumentation für das Attribut style.

 
styleClassString Über dieses Attribut kann direkt ein HTML-class Attribut angegeben werden.

Anmerkung: Siehe HTML Dokumentation für das Attribut class.

 
styleIdString Über dieses Attribut kann direkt ein HTML-id Attribut angegeben werden.

Anmerkung: Siehe HTML Dokumentation für das Attribut id.

 

[ Beispiel ]

Erzeugt ein einzelnes Optionselement.


<%@ taglib uri="http://struts.apache.org/tags-html"             prefix="html" %>
<%@ taglib uri="http://www.common-controls.com/cc/tags-base"   prefix="base" %>

<td nowrap>Change Status:</td>
<td>
    <html:select property="state">
        <base:option key="open" label="states.open"/>
        <base:option key="closed">Closed</base:option>
    </html:select>
</td>