Writes a set of <option value="foo">bar</option> tags to the page based on the
values of a enum. Each value in the enum is represented by a single option tag on the page. The
options will be generated in ordinal value order (i.e. the order they are declared in the
enum).
The label (the value the user sees) is generated in one of three ways: by looking up a
localized value, by using the property named by the 'label' tag attribute if it is supplied
and lastly by toString()'ing the enumeration value. For example the following tag:
If the class specified does not exist, or does not specify a Java 1.5 enum then a
JspException will be raised.
All attributes of the tag, other than enum and label, are passed directly through to
the <stripes:option/> which is used to generate the individual HTML
options tags. As a result the <stripes:options-enumeration/> will exhibit
the same re-population/selection behaviour as the regular options tag.
Since the tag has no use for one it does not allow a body.
Attributes |
Name | Required | Request-time | Type | Description |
enum | true | true | java.lang.String |
The fully qualified name of a Class that is a JDK1.5 enum.
|
label | false | true | java.lang.String |
The name of the property to be used at the label of each option. If not specifed,
and no localized value can be found, the toString() method will be called on the
enumerated objects to supply the user-visible text.
|
sort | false | true | java.lang.String |
A comma separated list of bean properties by which the enum values
should be sorted before rendering the options. Special values of
'label' and 'value' indicate that the options should be sorted by the
label and value respectively - even when using localized or derived values.
|
group | false | true | java.lang.String |
The name of the property which will be used to generate <optgroup> tags.
Each time a new value is encountered an optgroup will be written for it.
|
accesskey | false | true | java.lang.String | Keyboard shortcut to access the element. (HTML Pass-through) |
class | false | true | java.lang.String | The CSS class to be applied to the element. (HTML Pass-through) |
dir | false | true | java.lang.String | Text direction. (HTML Pass-through) |
id | false | true | java.lang.String | A unique identifier for the HTML tag on the page. (HTML Pass-through) |
lang | false | true | java.lang.String | The language code of the element. (HTML Pass-through) |
onblur | false | true | java.lang.String | Scripting code run when the element loses focus. (HTML Pass-through) |
onchange | false | true | java.lang.String | Scripting code run when the element changes. (HTML Pass-through) |
onclick | false | true | java.lang.String | Scripting code run on each mouse click. (HTML Pass-through) |
ondblclick | false | true | java.lang.String | Scripting code run on a double-click of the mouse. (HTML Pass-through) |
onfocus | false | true | java.lang.String | Scripting code run when the element acquires focus. (HTML Pass-through) |
onkeydown | false | true | java.lang.String | Scripting code run when a key is depressed. (HTML Pass-through) |
onkeypress | false | true | java.lang.String | Scripting code run when a key is pressed and released. (HTML Pass-through) |
onkeyup | false | true | java.lang.String | Scripting code run when a key is released. (HTML Pass-through) |
onmousedown | false | true | java.lang.String | Scripting code run when a mouse button is depressed. (HTML Pass-through) |
onmousemove | false | true | java.lang.String | Scripting code run when the mouse pointer is moved. (HTML Pass-through) |
onmouseout | false | true | java.lang.String | Scripting code run when the mouse pointer moves out of the element. (HTML Pass-through) |
onmouseover | false | true | java.lang.String | Scripting code run when the mouse pointer moves over the element. (HTML Pass-through) |
onmouseup | false | true | java.lang.String | Scripting code run when a mouse button is released. (HTML Pass-through) |
onselect | false | true | java.lang.String | Scripting code run when an element is selected. (HTML Pass-through) |
style | false | true | java.lang.String | Inline CSS style fragment that applies to the element (HTML Pass-through) |
tabindex | false | true | java.lang.String | The tab order of the element. (HTML Pass-through) |
title | false | true | java.lang.String | Tool-tip text for the element. (HTML Pass-through) |