`<ctrl:select>`

Das Tag erzeugt ein HTML Select Element welches in verbindung mit dem <base:options>-Tag verwendet werden kann.

../images/images/ctrlselect.gif

Body content: JSP
Tag class: SelectTag

[ Syntax ]

Standard Syntax

<ctrl:select

[ disabled = "Boolean" ]
[ id = "String" ]
[ multiple = "Boolean" ]
[ name = "String" ]
[ onblur = "String" ]
[ onchange = "String" ]
[ onclick = "String" ]
[ oncontextmenu = "String" ]
[ ondblclick = "String" ]
[ onfocus = "String" ]
[ onkeydown = "String" ]
[ onkeypress = "String" ]
[ onkeyup = "String" ]
[ onmousedown = "String" ]
[ onmousemove = "String" ]
[ onmouseout = "String" ]
[ onmouseover = "String" ]
[ onmouseup = "String" ]
[ property = "String" ]
[ scope = "{any | page | request | session | application}" ]
[ size = "Integer" ]
[ style = "String" ]
[ styleId = "String" ]
[ tabindex = "Integer" ]
[ tooltip = "String" ]
[ value = "String" ]
>
...Body Content...

</ctrl:select>

[ Attribute ]

Attribut	Typ	Beschreibung	Pflicht	RTExp
disabled	Boolean	Über dieses Attribut kann das Kontrollelement deaktiviert werden. Es nimmt dann keine Benutzereingaben entgegen und erzeugt keine Kontrollelement Ereignisse.
id	String	Weist dem Kontrollelement einen eindeutigen Bezeichner zu. Im Tag Body wird daraufhin eine Java Variable angelegt, auf die in Java Scriptlets zugegriffen werden kann. Diese Variable verweist auf die Kontrollelement Instanz (abgeleitet von Control). 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.
multiple	Boolean	Legt fest ob eine Mehrfachauswahl möglich ist
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.
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
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.
scope	HttpScope	Dieses Attribut gibt den Scope an, in welchem die Java-Bean mit den eigentlichen Anzeigedaten zu finden ist. any = Nach der Bean wird in jedem Scope gesucht. page = Die Bean liegt im PageContext der JSP Seite. request = Die Bean liegt im HTTP Servlet Request session = Die Bean liegt in der HTTP Session application = Die Bean liegt applikationsweit im Servlet Kontext
size	Integer	Gibt die Anzahl der sichtbaren Optionen an.
style	String	Über dieses Attribut kann direkt ein HTML-style Attribut angegeben werden. Anmerkung: Siehe HTML Dokumentation für das Attribut style.
styleId	String	Über dieses Attribut kann direkt ein HTML-id Attribut angegeben werden. Anmerkung: Siehe HTML Dokumentation für das Attribut id.
tabindex	Integer	Legt den Tabulator Index für dieses Element fest.
tooltip	String	Tooltip Text welcher in einem Popup Fenster angezeigt wird, wenn der Benutzer die Maus über das Kontrollelement bewegt. Die Zeichenkette wird vor der Ausgabe HTML-codiert
value	String	Der Wert des Kontrollelementes kann mit diesem Attribut auch direkt als Litteral angegeben werden.

[ Beispiel ]

Select Element

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

<ctrl:select name="mybean" property="localCurrency" multiple="true">
   <base:options  property="currencyOptions"/>
</ctrl:select>