html
Tag optionsCollection
Render a Collection of Select Options
Renders a set of HTML <option>
elements, representing possible choices for a <select>
element. This tag can be used multiple times within a single <html:select>
element, either in conjunction with or instead of one or more <html:option>
elements.
This tag operates on a collection of SourceBean
s, where each bean has a label named attribute and a value named attribute. The actual names of these SourceBean attributes
can be configured using the label
and value
attributes of this tag.
Note that this tag does not support a styleId
attribute, as it would have to apply the value to all the option
elements created by this element, which would mean that more than one id
element might have the same value, which the HTML specification says is illegal.
Tag Information |
Tag Class | it.eng.spago.taglib.html.OptionsCollectionTag |
TagExtraInfo Class | None |
Body Content | empty |
Display Name | None |
Attributes |
Name | Required | Request-time | Type | Description |
filter | false | true | boolean | Set to false if you do NOT want the option labels filtered for sensitive characters in HTML. By default, such values are filtered. |
isLabelKey | false | true | java.lang.String | If "true" all label attributes are used as key to be searched on resource bundle. |
label | false | true | java.lang.String | The attribute of the SourceBean within the collection which represents the label to be rendered for each option. Defaults to "label". If attribute isLabelKey is setted to true this attribute rappresent a key in the resource bundle. |
listAttribute | false | true | java.lang.String | See paramName |
paramName | false | true | java.lang.String | The attribute paramName is used in conjunction with the attribute paramValue and the attribute listAttribute to filter a SourceBeanAttribute. In this way is possible to navigate a SourceBean to a path that indicate a list of SourceBeanAttribute to filter; the filter is rappresented with the pair (paramName , paramValue ). If the obtained attribute contain a list identified by listAttribute , this list is returned. |
paramValue | false | true | java.lang.String | See paramName |
property | false | true | java.lang.String | The name of service context data that will rappresent a SourceBean list that will be rendered for these options. |
scope | false | true | java.lang.String | Scope used to retrive the value identified by property attribute. |
style | false | true | java.lang.String | CSS styles to be applied to this HTML element. |
styleClass | false | true | java.lang.String | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). |
value | false | true | java.lang.String | The attribute of the SourceBean within collection which represents the value to be rendered for each option. Defaults to "value". |
Variables |
No Variables Defined. |
Output Generated by
Tag Library Documentation Generator.
Java, JSP, and JavaServer Pages are trademarks or
registered trademarks of Sun Microsystems, Inc. in the US and other
countries. Copyright 2002-4 Sun Microsystems, Inc.
4150 Network Circle
Santa Clara, CA 95054, U.S.A.
All Rights Reserved.