public class SelectTag extends AbstractHtmlInputElementTag
<select> tag renders an HTML 'select' element.
Supports data binding to the selected option.
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.
| Attribute | Required? | Runtime Expression? | Description |
|---|---|---|---|
accesskey |
false |
true |
HTML Standard Attribute |
cssClass |
false |
true |
HTML Optional Attribute |
cssErrorClass |
false |
true |
HTML Optional Attribute. Used when the bound field has errors. |
cssStyle |
false |
true |
HTML Optional Attribute |
dir |
false |
true |
HTML Standard Attribute |
disabled |
false |
true |
HTML Optional Attribute. Setting the value of this attribute to 'true' will disable the HTML element. |
htmlEscape |
false |
true |
Enable/disable HTML escaping of rendered values. |
id |
false |
true |
HTML Standard Attribute |
itemLabel |
false |
true |
Name of the property mapped to the inner text of the 'option' tag |
items |
false |
true |
The Collection, Map or array of objects used to generate the inner 'option' tags |
itemValue |
false |
true |
Name of the property mapped to 'value' attribute of the 'option' tag |
lang |
false |
true |
HTML Standard Attribute |
multiple |
false |
true |
HTML Optional Attribute |
onblur |
false |
true |
HTML Event Attribute |
onchange |
false |
true |
HTML Event Attribute |
onclick |
false |
true |
HTML Event Attribute |
ondblclick |
false |
true |
HTML Event Attribute |
onfocus |
false |
true |
HTML Event Attribute |
onkeydown |
false |
true |
HTML Event Attribute |
onkeypress |
false |
true |
HTML Event Attribute |
onkeyup |
false |
true |
HTML Event Attribute |
onmousedown |
false |
true |
HTML Event Attribute |
onmousemove |
false |
true |
HTML Event Attribute |
onmouseout |
false |
true |
HTML Event Attribute |
onmouseover |
false |
true |
HTML Event Attribute |
onmouseup |
false |
true |
HTML Event Attribute |
path |
true |
true |
Path to property for data binding |
size |
false |
true |
HTML Optional Attribute |
tabindex |
false |
true |
HTML Standard Attribute |
title |
false |
true |
HTML Standard Attribute |
OptionTag,
Serialized Form| Modifier and Type | Field and Description |
|---|---|
static java.lang.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 java.lang.String |
getItemLabel()
Get the value of the '
itemLabel' attribute. |
protected java.lang.Object |
getItems()
Get the value of the '
items' attribute. |
protected java.lang.String |
getItemValue()
Get the value of the '
itemValue' attribute. |
protected java.lang.Object |
getMultiple()
Get the value of the HTML '
multiple' attribute rendered
on the final 'select' element. |
protected java.lang.String |
getSize()
Get the value of the '
size' attribute. |
void |
setItemLabel(java.lang.String itemLabel)
Set the name of the property mapped to the label (inner text) of the
'
option' tag. |
void |
setItems(java.lang.Object items)
Set the
Collection, Map or array of objects used to
generate the inner 'option' tags. |
void |
setItemValue(java.lang.String itemValue)
Set the name of the property mapped to the '
value'
attribute of the 'option' tag. |
void |
setMultiple(java.lang.Object multiple)
Set the value of the HTML '
multiple' attribute rendered
on the final 'select' element. |
void |
setSize(java.lang.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, writeOptionalAttributehtmlEscape, isHtmlEscape, isResponseEncodedHtmlEscape, setHtmlEscapedoCatch, doStartTag, getRequestContextdoAfterBody, findAncestorWithClass, getParent, getValue, getValues, release, removeValue, setPageContext, setParent, setValuepublic static final java.lang.String LIST_VALUE_PAGE_ATTRIBUTE
PageContext attribute under
which the bound value is exposed to inner OptionTags.public void setItems(java.lang.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 java.lang.Object getItems()
items' attribute.
May be a runtime expression.
public void setItemValue(java.lang.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 java.lang.String getItemValue()
itemValue' attribute.
May be a runtime expression.
public void setItemLabel(java.lang.String itemLabel)
option' tag.
May be a runtime expression.
protected java.lang.String getItemLabel()
itemLabel' attribute.
May be a runtime expression.
public void setSize(java.lang.String size)
size' attribute rendered
on the final 'select' element.protected java.lang.String getSize()
size' attribute.public void setMultiple(java.lang.Object multiple)
multiple' attribute rendered
on the final 'select' element.protected java.lang.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