org.apache.struts.taglib.html
public class OptionsTag extends TagSupport
Field Summary | |
---|---|
protected String | collection
The name of the collection containing beans that have properties to
provide both the values and the labels (identified by the
property and labelProperty attributes). |
protected boolean | filter
Should the label values be filtered for HTML sensitive characters? |
protected String | labelName
The name of the bean containing the labels collection. |
protected String | labelProperty
The bean property containing the labels collection. |
protected static MessageResources | messages
The message resources for this package. |
protected String | name
The name of the bean containing the values collection. |
protected String | property
The name of the property to use to build the values collection. |
String | style
The style associated with this tag. |
String | styleClass
The named style class associated with this tag. |
Method Summary | |
---|---|
protected void | addOption(StringBuffer sb, String value, String label, boolean matched)
Add an option element to the specified StringBuffer based on the
specified parameters.
|
int | doEndTag()
Process the end of this tag.
|
int | doStartTag()
Process the start of this tag.
|
String | getCollection() |
boolean | getFilter() |
protected Iterator | getIterator(String name, String property)
Return an iterator for the option labels or values, based on our
configured properties.
|
String | getLabelName() |
String | getLabelProperty() |
String | getName() |
String | getProperty() |
String | getStyle() |
String | getStyleClass() |
void | release()
Release any acquired resources. |
void | setCollection(String collection) |
void | setFilter(boolean filter) |
void | setLabelName(String labelName) |
void | setLabelProperty(String labelProperty) |
void | setName(String name) |
void | setProperty(String property) |
void | setStyle(String style) |
void | setStyleClass(String styleClass) |
property
and labelProperty
attributes).
Note that this tag specifically does not support the
styleId
tag attribute, which causes the HTML
id
attribute to be emitted. This is because the HTML
specification states that all "id" attributes in a document have to be
unique. This tag will likely generate more than one option
element element, but it cannot use the same id
value. It's
conceivable some sort of mechanism to supply an array of id
values could be devised, but that doesn't seem to be worth the trouble.
Parameters: sb StringBuffer accumulating our results value Value to be returned to the server for this option label Value to be shown to the user for this option matched Should this value be marked as selected?
Throws: JspException if a JSP exception has occurred
Throws: JspException if a JSP exception has occurred
Parameters: name Name of the bean attribute (if any) property Name of the bean property (if any)
Throws: JspException if an error occurs