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 SourceBeans, 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 Classit.eng.spago.taglib.html.OptionsCollectionTag
TagExtraInfo ClassNone
Body Contentempty
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
filterfalsetruebooleanSet to false if you do NOT want the option labels filtered for sensitive characters in HTML. By default, such values are filtered.
isLabelKeyfalsetruejava.lang.StringIf "true" all label attributes are used as key to be searched on resource bundle.
labelfalsetruejava.lang.StringThe 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.
listAttributefalsetruejava.lang.StringSee paramName
paramNamefalsetruejava.lang.StringThe 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.
paramValuefalsetruejava.lang.StringSee paramName
propertyfalsetruejava.lang.StringThe name of service context data that will rappresent a SourceBean list that will be rendered for these options.
scopefalsetruejava.lang.StringScope used to retrive the value identified by property attribute.
stylefalsetruejava.lang.StringCSS styles to be applied to this HTML element.
styleClassfalsetruejava.lang.StringCSS stylesheet class to be applied to this HTML element (renders a "class" attribute).
valuefalsetruejava.lang.StringThe 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.