Class OptionsTag
- java.lang.Object
- javax.servlet.jsp.tagext.TagSupport
- org.springframework.web.servlet.tags.RequestContextAwareTag
- org.springframework.web.servlet.tags.HtmlEscapingAwareTag
- org.springframework.web.servlet.tags.form.AbstractFormTag
- org.springframework.web.servlet.tags.form.AbstractDataBoundFormElementTag
- org.springframework.web.servlet.tags.form.AbstractHtmlElementTag
- org.springframework.web.servlet.tags.form.OptionsTag
- All Implemented Interfaces:
Serializable
,DynamicAttributes
,IterationTag
,JspTag
,Tag
,TryCatchFinally
,EditorAwareTag
public class OptionsTag extends AbstractHtmlElementTag
Convenient tag that allows one to supply a collection of objects that are to be rendered as 'option
' tags within a 'select
' tag.Must be used within a
'select' tag
.- Since:
- 2.0
- Author:
- Rob Harrop, Juergen Hoeller, Scott Andrews
- See Also:
- Serialized Form
Field Summary
Fields inherited from class org.springframework.web.servlet.tags.form.AbstractHtmlElementTag
CLASS_ATTRIBUTE, DIR_ATTRIBUTE, LANG_ATTRIBUTE, ONCLICK_ATTRIBUTE, ONDBLCLICK_ATTRIBUTE, ONKEYDOWN_ATTRIBUTE, ONKEYPRESS_ATTRIBUTE, ONKEYUP_ATTRIBUTE, ONMOUSEDOWN_ATTRIBUTE, ONMOUSEMOVE_ATTRIBUTE, ONMOUSEOUT_ATTRIBUTE, ONMOUSEOVER_ATTRIBUTE, ONMOUSEUP_ATTRIBUTE, STYLE_ATTRIBUTE, TABINDEX_ATTRIBUTE, TITLE_ATTRIBUTE
Fields inherited from class org.springframework.web.servlet.tags.form.AbstractDataBoundFormElementTag
NESTED_PATH_VARIABLE_NAME
Fields inherited from class org.springframework.web.servlet.tags.RequestContextAwareTag
logger, REQUEST_CONTEXT_PAGE_ATTRIBUTE
Fields inherited from class javax.servlet.jsp.tagext.TagSupport
pageContext
Fields inherited from interface javax.servlet.jsp.tagext.IterationTag
EVAL_BODY_AGAIN
Fields inherited from interface javax.servlet.jsp.tagext.Tag
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
Constructor Summary
Constructors Constructor Description OptionsTag()
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected BindStatus
getBindStatus()
Get theBindStatus
for this tag.protected String
getItemLabel()
Get the name of the property mapped to the label (inner text) of the 'option
' tag.protected Object
getItems()
protected String
getItemValue()
Return the name of the property mapped to the 'value
' attribute of the 'option
' tag.protected boolean
isDisabled()
Get the value of the 'disabled
' attribute.protected String
resolveId()
Appends a counter to a specified id, since we're dealing with multiple HTML elements.void
setDisabled(boolean disabled)
Set the value of the 'disabled
' attribute.void
setItemLabel(String itemLabel)
Set the name of the property mapped to the label (inner text) of the 'option
' tag.void
setItems(Object items)
void
setItemValue(String itemValue)
Set the name of the property mapped to the 'value
' attribute of the 'option
' tag.protected int
writeTagContent(TagWriter tagWriter)
Subclasses should implement this method to perform tag content rendering.Methods inherited from class org.springframework.web.servlet.tags.form.AbstractHtmlElementTag
getCssClass, getCssErrorClass, getCssStyle, getDir, getDynamicAttributes, getLang, getOnclick, getOndblclick, getOnkeydown, getOnkeypress, getOnkeyup, getOnmousedown, getOnmousemove, getOnmouseout, getOnmouseover, getOnmouseup, getTabindex, getTitle, isValidDynamicAttribute, resolveCssClass, setCssClass, setCssErrorClass, setCssStyle, setDir, setDynamicAttribute, setLang, setOnclick, setOndblclick, setOnkeydown, setOnkeypress, setOnkeyup, setOnmousedown, setOnmousemove, setOnmouseout, setOnmouseover, setOnmouseup, setTabindex, setTitle, writeDefaultAttributes, writeOptionalAttributes
Methods inherited from class org.springframework.web.servlet.tags.form.AbstractDataBoundFormElementTag
autogenerateId, convertToDisplayString, doFinally, getBoundValue, getEditor, getId, getName, getNestedPath, getPath, getPropertyEditor, getPropertyPath, processFieldValue, setId, setPath
Methods inherited from class org.springframework.web.servlet.tags.form.AbstractFormTag
createTagWriter, doStartTagInternal, evaluate, getDisplayString, getDisplayString, isDefaultHtmlEscape, writeOptionalAttribute
Methods inherited from class org.springframework.web.servlet.tags.HtmlEscapingAwareTag
htmlEscape, isHtmlEscape, isResponseEncodedHtmlEscape, setHtmlEscape
Methods inherited from class org.springframework.web.servlet.tags.RequestContextAwareTag
doCatch, doStartTag, getRequestContext
Methods inherited from class javax.servlet.jsp.tagext.TagSupport
doAfterBody, doEndTag, findAncestorWithClass, getParent, getValue, getValues, release, removeValue, setPageContext, setParent, setValue
Constructor Detail
OptionsTag
public OptionsTag()
Method Detail
setItems
public void setItems(Object items)
Set theCollection
,Map
or array of objects used to generate the inner 'option
' tags.Required when wishing to render '
option
' tags from an array,Collection
orMap
.Typically a runtime expression.
getItems
protected Object getItems()
Get theCollection
,Map
or array of objects used to generate the inner 'option
' tags.Typically a runtime expression.
setItemValue
public void setItemValue(String itemValue)
Set the name of the property mapped to the 'value
' attribute of the 'option
' tag.Required when wishing to render '
option
' tags from an array orCollection
.
getItemValue
protected String getItemValue()
Return the name of the property mapped to the 'value
' attribute of the 'option
' tag.
setItemLabel
public void setItemLabel(String itemLabel)
Set the name of the property mapped to the label (inner text) of the 'option
' tag.
getItemLabel
protected String getItemLabel()
Get the name of the property mapped to the label (inner text) of the 'option
' tag.
setDisabled
public void setDisabled(boolean disabled)
Set the value of the 'disabled
' attribute.
isDisabled
protected boolean isDisabled()
Get the value of the 'disabled
' attribute.
writeTagContent
protected int writeTagContent(TagWriter tagWriter) throws JspException
Description copied from class:AbstractFormTag
Subclasses should implement this method to perform tag content rendering.- Specified by:
writeTagContent
in classAbstractFormTag
- Returns:
- valid tag render instruction as per
Tag.doStartTag()
. - Throws:
JspException
resolveId
protected String resolveId() throws JspException
Appends a counter to a specified id, since we're dealing with multiple HTML elements.- Overrides:
resolveId
in classAbstractDataBoundFormElementTag
- Throws:
JspException
- See Also:
AbstractDataBoundFormElementTag.getId()
,AbstractDataBoundFormElementTag.autogenerateId()
getBindStatus
protected BindStatus getBindStatus()
Description copied from class:AbstractDataBoundFormElementTag
Get theBindStatus
for this tag.- Overrides:
getBindStatus
in classAbstractDataBoundFormElementTag