public class SelectTag extends AbstractHtmlInputElementTag
select'
element.
Inner 'option' tags can be rendered using one of the
approaches supported by the OptionWriter class.
Also supports the use of nested OptionTags or
(typically one) nested OptionsTag.
OptionTag,
Serialized Form| Modifier and Type | Field and Description |
|---|---|
static String |
LIST_VALUE_PAGE_ATTRIBUTE
The
PageContext attribute under
which the bound value is exposed to inner OptionTags. |
ACCESSKEY_ATTRIBUTE, DISABLED_ATTRIBUTE, ONBLUR_ATTRIBUTE, ONCHANGE_ATTRIBUTE, ONFOCUS_ATTRIBUTE, READONLY_ATTRIBUTECLASS_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_ATTRIBUTENESTED_PATH_VARIABLE_NAMElogger, REQUEST_CONTEXT_PAGE_ATTRIBUTEpageContextEVAL_BODY_AGAINEVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE| Constructor and Description |
|---|
SelectTag() |
| Modifier and Type | Method and Description |
|---|---|
int |
doEndTag()
Closes any block tag that might have been opened when using
nested
options. |
void |
doFinally()
|
protected String |
getItemLabel()
Get the value of the '
itemLabel' attribute. |
protected Object |
getItems()
Get the value of the '
items' attribute. |
protected String |
getItemValue()
Get the value of the '
itemValue' attribute. |
protected Object |
getMultiple()
Get the value of the HTML '
multiple' attribute rendered
on the final 'select' element. |
protected String |
getSize()
Get the value of the '
size' 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. |
void |
setMultiple(Object multiple)
Set the value of the HTML '
multiple' attribute rendered
on the final 'select' element. |
void |
setSize(String size)
Set the value of the HTML '
size' attribute rendered
on the final 'select' element. |
protected int |
writeTagContent(TagWriter tagWriter)
Renders the HTML '
select' tag to the supplied
TagWriter. |
getAccesskey, getOnblur, getOnchange, getOnfocus, isDisabled, isReadonly, setAccesskey, setDisabled, setOnblur, setOnchange, setOnfocus, setReadonly, writeOptionalAttributesgetCssClass, 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, writeDefaultAttributesautogenerateId, convertToDisplayString, getBindStatus, getBoundValue, getEditor, getId, getName, getNestedPath, getPath, getPropertyEditor, getPropertyPath, processFieldValue, resolveId, setId, setPathcreateTagWriter, doStartTagInternal, evaluate, getDisplayString, getDisplayString, isDefaultHtmlEscape, writeOptionalAttributeisHtmlEscape, setHtmlEscapedoCatch, doStartTag, getRequestContextdoAfterBody, findAncestorWithClass, getParent, getValue, getValues, release, removeValue, setPageContext, setParent, setValuepublic static final String LIST_VALUE_PAGE_ATTRIBUTE
PageContext attribute under
which the bound value is exposed to inner OptionTags.public void setItems(Object items)
Collection, Map or array of objects used to
generate the inner 'option' tags.
Required when wishing to render 'option' tags from
an array, Collection or Map.
Typically a runtime expression.
items - the items that comprise the options of this selectionprotected Object getItems()
items' attribute.
May be a runtime expression.
public void setItemValue(String itemValue)
value'
attribute of the 'option' tag.
Required when wishing to render 'option' tags from
an array or Collection.
May be a runtime expression.
protected String getItemValue()
itemValue' attribute.
May be a runtime expression.
public void setItemLabel(String itemLabel)
option' tag.
May be a runtime expression.
protected String getItemLabel()
itemLabel' attribute.
May be a runtime expression.
public void setSize(String size)
size' attribute rendered
on the final 'select' element.protected String getSize()
size' attribute.public void setMultiple(Object multiple)
multiple' attribute rendered
on the final 'select' element.protected Object getMultiple()
multiple' attribute rendered
on the final 'select' element.protected int writeTagContent(TagWriter tagWriter) throws JspException
select' tag to the supplied
TagWriter.
Renders nested 'option' tags if the
items property is set, otherwise exposes the
bound value for the nested OptionTags.
writeTagContent in class AbstractFormTagTag.doStartTag().JspExceptionpublic int doEndTag()
throws JspException
options.doEndTag in interface TagdoEndTag in class TagSupportJspExceptionpublic void doFinally()
doFinally in interface TryCatchFinallydoFinally in class AbstractDataBoundFormElementTag