|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.sourceforge.stripes.tag.StripesTagSupport
net.sourceforge.stripes.tag.HtmlTagSupport
net.sourceforge.stripes.tag.InputTagSupport
net.sourceforge.stripes.tag.InputCheckBoxTag
public class InputCheckBoxTag
Implements an HTML tag that generates form fields of type <input type="checkbox"/>. Since a single checkbox widget on a HTML page can have only a single value, the value tag attribute must always resolve to a scalar value which will be converted to a String using the Stripes Formatting system, or by caling toString() if an appropriate Formatter is not found.
Checkboxes perform automatic (re-)population of state. They prefer, in order, values in the HttpServletRequest, values in the ActionBean and lastly values set using checked="" on the page. The "checked" attribute is a complex attribute and may be a Collection, an Array or a scalar Java Object. In the first two cases a check is performed to see if the value in the value="foo" attribute is one of the elements in the checked collection or array. In the last case, the value is matched directly against the String form of the checked attribute. If in any case a checkbox's value matches then a checked="checked" attribute will be added to the HTML written.
The tag may include a body and if present the body is converted to a String and overrides the checked tag attribute.
Field Summary |
---|
Fields inherited from class net.sourceforge.stripes.tag.InputTagSupport |
---|
errorRenderer, fieldErrors |
Fields inherited from class net.sourceforge.stripes.tag.StripesTagSupport |
---|
pageContext, parentTag |
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 | |
---|---|
InputCheckBoxTag()
Basic constructor that sets the input tag's type attribute to "checkbox". |
Method Summary | |
---|---|
int |
doAfterBody()
Ensure that the body is evaluated only once. |
int |
doEndInputTag()
Does the main work of the tag, including determining the tags state (checked or not) and writing out a singleton tag representing the checkbox. |
void |
doInitBody()
Does nothing. |
int |
doStartInputTag()
Does nothing. |
Object |
getChecked()
Returns the value originally set using setChecked(). |
Object |
getValue()
Returns the value that this checkbox will submit if it is checked. |
Object |
getValueOnPage()
Returns the body of the tag if it is present and not empty, otherwise returns the value of the 'checked' attribute. |
void |
setChecked(Object checked)
Sets the default checked values for checkboxes with this name. |
void |
setValue(Object value)
Sets the value that this checkbox will submit if it is checked. |
Methods inherited from class net.sourceforge.stripes.tag.InputTagSupport |
---|
doCatch, doEndTag, doFinally, doStartTag, format, format, getActionBean, getDisabled, getFieldErrors, getFormatPattern, getFormatType, getLocalizedFieldName, getLocalizedFieldName, getName, getOverrideValueOrValues, getParentFormTag, getReadonly, getSingleOverrideValue, getSize, getValidationMetadata, hasErrors, isItemSelected, loadErrors, makeFocused, registerWithParentForm, setDisabled, setFocus, setFormatPattern, setFormatType, setName, setReadonly, setSize |
Methods inherited from class net.sourceforge.stripes.tag.HtmlTagSupport |
---|
evaluateExpression, get, getAccesskey, getAttributes, getBodyContent, getBodyContentAsString, getCssClass, getDir, getId, getLang, getOnblur, getOnchange, getOnclick, getOndblclick, getOnfocus, getOnkeydown, getOnkeypress, getOnkeyup, getOnmousedown, getOnmousemove, getOnmouseout, getOnmouseover, getOnmouseup, getOnselect, getStyle, getTabindex, getTitle, release, set, setAccesskey, setBodyContent, setClass, setCssClass, setDir, setDynamicAttribute, setId, setLang, setOnblur, setOnchange, setOnclick, setOndblclick, setOnfocus, setOnkeydown, setOnkeypress, setOnkeyup, setOnmousedown, setOnmousemove, setOnmouseout, setOnmouseover, setOnmouseup, setOnselect, setStyle, setTabindex, setTitle, toString, writeAttributes, writeCloseTag, writeOpenTag, writeSingletonTag |
Methods inherited from class net.sourceforge.stripes.tag.StripesTagSupport |
---|
getActionBeanType, getActionBeanUrl, getPageContext, getParent, getParentTag, getTagStack, popPageContextAttributes, pushPageContextAttributes, setPageContext, setParent |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface javax.servlet.jsp.tagext.BodyTag |
---|
setBodyContent |
Methods inherited from interface javax.servlet.jsp.tagext.Tag |
---|
doEndTag, doStartTag, getParent, release, setPageContext, setParent |
Constructor Detail |
---|
public InputCheckBoxTag()
Method Detail |
---|
public void setChecked(Object checked)
checked
- may be either a Collection or Array of checked values, or a single Checked
value. Values do not have to be Strings, but will need to be convertible to String
using the toString() method.public Object getChecked()
public void setValue(Object value)
public Object getValue()
public int doStartInputTag() throws JspException
doStartInputTag
in class InputTagSupport
JspException
public void doInitBody() throws JspException
doInitBody
in interface BodyTag
JspException
public int doAfterBody() throws JspException
doAfterBody
in interface IterationTag
JspException
public Object getValueOnPage()
getValueOnPage
in class InputTagSupport
public int doEndInputTag() throws JspException
doEndInputTag
in class InputTagSupport
JspException
- if the checkbox is not contained inside a stripes InputFormTag, or has
problems writing to the output.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |