|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
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.AbstractHtmlElementBodyTag org.springframework.web.servlet.tags.form.OptionTag
public class OptionTag
JSP tag for rendering an HTML 'option
' tag.
Must be used nested inside a SelectTag
.
Provides full support for databinding by marking an
'option
' as 'selected' if the value
matches the value bound to the out SelectTag
.
The value
property is required and corresponds to
the 'value
' attribute of the rendered 'option
'.
An optional label
property can be specified, the
value of which corresponds to inner text of the rendered
'option
' tag. If no label
is specified
then the value
property will be used when rendering
the inner text.
Field Summary | |
---|---|
static String |
DISPLAY_VALUE_VARIABLE_NAME
The name of the JSP variable used to expose the display value for this tag. |
static String |
VALUE_VARIABLE_NAME
The name of the JSP variable used to expose the value for this tag. |
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 |
---|
ID_ATTRIBUTE |
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.BodyTag |
---|
EVAL_BODY_BUFFERED, EVAL_BODY_TAG |
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 | |
---|---|
OptionTag()
|
Method Summary | |
---|---|
protected void |
exposeAttributes()
Called during AbstractHtmlElementBodyTag.writeTagContent(org.springframework.web.servlet.tags.form.TagWriter) allowing subclasses to add any attributes to the
PageContext as needed. |
protected BindStatus |
getBindStatus()
Gets the BindStatus for this tag. |
protected String |
getDisabled()
Gets the value of the ' disabled ' attribute. |
protected String |
getLabel()
Gets the text body of the rendered HTML <option> tag. |
protected Object |
getValue()
Gets the 'value' attribute of the rendered HTML <option> tag. |
protected boolean |
isDisabled()
Is the current HTML tag disabled? |
protected void |
onWriteTagContent()
Make sure we are under a ' select ' tag before proceeding. |
protected void |
removeAttributes()
Called by AbstractHtmlElementBodyTag.doFinally() allowing subclasses to remove any attributes from the
PageContext as needed. |
protected void |
renderDefaultContent(TagWriter tagWriter)
|
protected void |
renderFromBodyContent(BodyContent bodyContent,
TagWriter tagWriter)
Render the tag contents based on the supplied BodyContent . |
void |
setDisabled(String disabled)
Sets the value of the ' disabled ' attribute. |
void |
setLabel(String label)
Sets the text body of the rendered HTML <option> tag. |
void |
setValue(Object value)
Sets the 'value' attribute of the rendered HTML <option> tag. |
Methods inherited from class org.springframework.web.servlet.tags.form.AbstractHtmlElementBodyTag |
---|
doEndTag, doFinally, doInitBody, flushBufferedBodyContent, setBodyContent, shouldRender, writeTagContent |
Methods inherited from class org.springframework.web.servlet.tags.form.AbstractHtmlElementTag |
---|
getCssClass, getCssErrorClass, getCssStyle, getDir, getLang, getOnclick, getOndblclick, getOnkeydown, getOnkeypress, getOnkeyup, getOnmousedown, getOnmousemove, getOnmouseout, getOnmouseover, getOnmouseup, getTabindex, getTitle, resolveCssClass, setCssClass, setCssErrorClass, setCssStyle, setDir, setLang, setOnclick, setOndblclick, setOnkeydown, setOnkeypress, setOnkeyup, setOnmousedown, setOnmousemove, setOnmouseout, setOnmouseover, setOnmouseup, setTabindex, setTitle, writeDefaultAttributes |
Methods inherited from class org.springframework.web.servlet.tags.form.AbstractDataBoundFormElementTag |
---|
autogenerateId, getBoundValue, getId, getName, getNestedPath, getPath, getPropertyEditor, setId, setPath |
Methods inherited from class org.springframework.web.servlet.tags.form.AbstractFormTag |
---|
createTagWriter, doStartTagInternal, evaluate, getDisplayString, getDisplayString, writeOptionalAttribute |
Methods inherited from class org.springframework.web.servlet.tags.HtmlEscapingAwareTag |
---|
isHtmlEscape, setHtmlEscape |
Methods inherited from class org.springframework.web.servlet.tags.RequestContextAwareTag |
---|
doCatch, doStartTag, getRequestContext |
Methods inherited from class javax.servlet.jsp.tagext.TagSupport |
---|
doAfterBody, findAncestorWithClass, getParent, getValue, getValues, release, removeValue, setPageContext, setParent, setValue |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface javax.servlet.jsp.tagext.BodyTag |
---|
doInitBody, setBodyContent |
Methods inherited from interface javax.servlet.jsp.tagext.IterationTag |
---|
doAfterBody |
Methods inherited from interface javax.servlet.jsp.tagext.Tag |
---|
doEndTag, doStartTag, getParent, release, setPageContext, setParent |
Field Detail |
---|
public static final String VALUE_VARIABLE_NAME
public static final String DISPLAY_VALUE_VARIABLE_NAME
Constructor Detail |
---|
public OptionTag()
Method Detail |
---|
public void setValue(Object value)
<option>
tag.
May be a runtime expression.
protected Object getValue()
<option>
tag.
May be a runtime expression.
public void setDisabled(String disabled)
disabled
' attribute.
May be a runtime expression.
disabled
- the value of the 'disabled
' attributeprotected String getDisabled()
disabled
' attribute.
May be a runtime expression.
disabled
' attributeprotected boolean isDisabled()
true
if this tag is disabledpublic void setLabel(String label)
<option>
tag.
May be a runtime expression.
IllegalArgumentException
- if the supplied label
is null
protected String getLabel()
<option>
tag.
May be a runtime expression.
protected void renderDefaultContent(TagWriter tagWriter) throws JspException
renderDefaultContent
in class AbstractHtmlElementBodyTag
JspException
protected void renderFromBodyContent(BodyContent bodyContent, TagWriter tagWriter) throws JspException
AbstractHtmlElementBodyTag
BodyContent
. The default
implementation simply flushes
the BodyContent
directly to the output. Subclasses may choose to override this to add additional content
to the output.
renderFromBodyContent
in class AbstractHtmlElementBodyTag
JspException
protected void onWriteTagContent()
select
' tag before proceeding.
onWriteTagContent
in class AbstractHtmlElementBodyTag
protected void exposeAttributes() throws JspException
AbstractHtmlElementBodyTag
AbstractHtmlElementBodyTag.writeTagContent(org.springframework.web.servlet.tags.form.TagWriter)
allowing subclasses to add any attributes to the
PageContext
as needed.
exposeAttributes
in class AbstractHtmlElementBodyTag
JspException
protected BindStatus getBindStatus()
AbstractDataBoundFormElementTag
BindStatus
for this tag.
getBindStatus
in class AbstractDataBoundFormElementTag
protected void removeAttributes()
AbstractHtmlElementBodyTag
AbstractHtmlElementBodyTag.doFinally()
allowing subclasses to remove any attributes from the
PageContext
as needed.
removeAttributes
in class AbstractHtmlElementBodyTag
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |