Class FormElementTag

java.lang.Object

jakarta.servlet.jsp.tagext.TagSupport

org.deltava.taglib.BrowserInfoTag

org.deltava.taglib.html.ElementTag

org.deltava.taglib.html.FormElementTag

All Implemented Interfaces:

jakarta.servlet.jsp.tagext.IterationTag, jakarta.servlet.jsp.tagext.JspTag, jakarta.servlet.jsp.tagext.Tag, Serializable

Direct Known Subclasses:

CheckTag, ComboTag, FileUploadTag, InputTag, SingleTag, TextboxTag

public abstract class FormElementTag
extends ElementTag

A class for supporting JSP tags that generate HTML input elements.

Since:

1.0

Version:

10.0

Author:

Luke

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected Object	_value	The value of this input element.

Fields inherited from class ElementTag

_classes, _data, _out

Modifier and Type	Field	Description
protected final Collection<String>	_classes
protected final XMLRenderer	_data
protected jakarta.servlet.jsp.JspWriter	_out

Fields inherited from class jakarta.servlet.jsp.tagext.TagSupport

id, pageContext

Fields inherited from interface jakarta.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

Fields inherited from interface jakarta.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	FormElementTag(String elementName, boolean validateParent)	Generates an input element tag with a given name.

Method Summary

Modifier and Type	Method	Description
void	setDelimValues(String values)	Sets multiple values for this input element.
void	setIdx(String index)	Sets the tab index of this field.
void	setName(String name)	Sets the name of this field.
void	setRequired(boolean isRequired)	Sets this field as required for HTML5 browsers.
void	setValue(Object value)	Sets the value of this input element.
protected void	validateState()	Validates tag state.

Methods inherited from class ElementTag

doStartTag, getFormIndexCount, getName, getParentFormTag, release, setClassName, setID, setNumericAttr, setPageContext, setStyle

Modifier and Type	Method	Description
int	doStartTag()
protected int	getFormIndexCount()	Gets and increments the current tab index count for the parent form tag.
protected String	getName()	Returns the type of HTML element this tag generated.
protected FormTag	getParentFormTag()	Returns the parent form tag.
void	release()
void	setClassName(String cName)	Sets the CSS class name of this HTML element.
void	setID(String id)	Sets the ID of this HTML element.
protected void	setNumericAttr(String attrName, int value, int minValue)	Sets a numeric attribute.
void	setPageContext(jakarta.servlet.jsp.PageContext ctxt)
void	setStyle(String style)	Associates a CSS style with this HTML element.

Methods inherited from class BrowserInfoTag

getBrowserContext, passedCAPTCHA

Modifier and Type	Method	Description
protected HTTPContextData	getBrowserContext()	Fetches the browser data.
protected boolean	passedCAPTCHA()	Returns whether the user has passed CAPTCHA validation.

Methods inherited from class jakarta.servlet.jsp.tagext.TagSupport

doAfterBody, doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setParent, setValue

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

_value

protected Object _value

The value of this input element.

Constructor Details

FormElementTag

protected FormElementTag(String elementName,
 boolean validateParent)

Generates an input element tag with a given name.

Parameters:

elementName - the HTML element name

validateParent - TRUE if parent validation is enabled, otherwise FALSE

See Also:

• validateState()

Method Details

setName

public void setName(String name)

Sets the name of this field.

Parameters:

name - the field name

setIdx

public void setIdx(String index)

Sets the tab index of this field. This does nothing if a negative, zero or non-numeric value is passed.

Parameters:

index - the tab index, or * if it should be retrieved from the parent form.

See Also:

• ElementTag.setNumericAttr(String, int, int)

setValue

public void setValue(Object value)

Sets the value of this input element. Each implementer needs to render multiple values appropriately.

Parameters:

value - the value(s) for this field

setRequired

public void setRequired(boolean isRequired)

Sets this field as required for HTML5 browsers.

Parameters:

isRequired - TRUE if required, otherwise FALSE

setDelimValues

public void setDelimValues(String values)

Sets multiple values for this input element.

Parameters:

values - a comma-delimited list of values

validateState

protected void validateState()

Validates tag state.

Throws:

IllegalStateException - if not in a FORM and is required