|
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.LabelTag
public class LabelTag
Databinding-aware JSP tag for rendering an HTML 'label
' element
that defines text that is associated with a single form element.
The 'for'
attribute is required.
See the "formTags" showcase application that ships with the full Spring distribution for an example of this class in action.
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 |
---|
COMMAND_NAME_VARIABLE_NAME, 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 | |
---|---|
LabelTag()
|
Method Summary | |
---|---|
protected String |
autogenerateFor()
Autogenerate the ' for ' attribute value for this tag. |
int |
doEndTag()
Close the ' label ' tag. |
void |
doFinally()
Disposes of the TagWriter instance. |
String |
getFor()
Get the value of the ' id ' attribute. |
protected String |
getName()
Overrides getName() to always return null ,
because the 'name ' attribute is not supported by the
'label ' tag. |
protected String |
resolveFor()
Determine the ' for ' attribute value for this tag,
autogenerating one if none specified. |
void |
setFor(String forId)
Set the value of the ' for ' attribute. |
protected int |
writeTagContent(TagWriter tagWriter)
Writes the opening ' label ' tag and forces a block tag so
that body content is written correctly. |
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, writeOptionalAttributes |
Methods inherited from class org.springframework.web.servlet.tags.form.AbstractDataBoundFormElementTag |
---|
autogenerateId, getBindStatus, getBoundValue, getEditor, getId, getNestedPath, getPath, getPropertyEditor, getPropertyPath, resolveId, 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 |
---|
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 |
Constructor Detail |
---|
public LabelTag()
Method Detail |
---|
public void setFor(String forId)
for
' attribute.
Defaults to the value of AbstractDataBoundFormElementTag.getPath()
; may be a runtime expression.
IllegalArgumentException
- if the supplied value is null
public String getFor()
id
' attribute.
May be a runtime expression.
protected int writeTagContent(TagWriter tagWriter) throws JspException
label
' tag and forces a block tag so
that body content is written correctly.
writeTagContent
in class AbstractFormTag
Tag.EVAL_BODY_INCLUDE
JspException
protected String getName() throws JspException
getName()
to always return null
,
because the 'name
' attribute is not supported by the
'label
' tag.
getName
in class AbstractDataBoundFormElementTag
name
' attribute
JspException
protected String resolveFor() throws JspException
for
' attribute value for this tag,
autogenerating one if none specified.
JspException
getFor()
,
autogenerateFor()
protected String autogenerateFor() throws JspException
for
' attribute value for this tag.
The default implementation delegates to AbstractDataBoundFormElementTag.getPropertyPath()
,
deleting invalid characters (such as "[" or "]").
JspException
public int doEndTag() throws JspException
label
' tag.
doEndTag
in interface Tag
doEndTag
in class TagSupport
JspException
public void doFinally()
TagWriter
instance.
doFinally
in interface TryCatchFinally
doFinally
in class AbstractDataBoundFormElementTag
|
The Spring Framework | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |