org.apache.struts.taglib.html

Class SelectTag

Known Direct Subclasses:
NestedSelectTag

public class SelectTag
extends BaseHandlerTag

Custom tag that represents an HTML select element, associated with a bean property specified by our attributes. This tag must be nested inside a form tag.
Version:
$Rev: 54929 $ $Date: 2004-10-16 17:38:42 +0100 (Sat, 16 Oct 2004) $

Field Summary

protected String[]
match
The actual values we will match against, calculated in doStartTag().
protected static MessageResources
messages
The message resources for this package.
protected String
multiple
Should multiple selections be allowed.
protected String
name
The name of the bean containing our underlying property.
protected String
property
The property name we are associated with.
protected String
saveBody
The saved body content of this tag.
protected String
size
How many available options should be displayed when this element is rendered?
protected String
value
The value to compare with for marking an option selected.

Fields inherited from class org.apache.struts.taglib.html.BaseHandlerTag

accesskey, alt, altKey, bundle, defaultLocale, disabled, doDisabled, doReadonly, errorKey, errorStyle, errorStyleClass, errorStyleId, indexed, locale, log, loopTagStatusClass, loopTagStatusGetIndex, loopTagSupportClass, loopTagSupportGetStatus, messages, onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onselect, readonly, style, styleClass, styleId, tabindex, title, titleKey, triedJstlInit, triedJstlSuccess

Method Summary

private void
calculateMatchValues()
Calculate the match values we will actually be using.
int
doAfterBody()
Save any body content of this tag, which will generally be the option(s) representing the values displayed to the user.
int
doEndTag()
Render the end of this form.
int
doStartTag()
Render the beginning of this select tag.
String
getMultiple()
String
getName()
String
getProperty()
Return the property name.
String
getSize()
String
getValue()
Return the comparison value.
boolean
isMatched(String value)
Does the specified value match one of those we are looking for?
protected String
prepareName()
Prepare the name element
void
release()
Release any acquired resources.
protected String
renderSelectStartElement()
Create an appropriate select start element based on our parameters.
void
setMultiple(String multiple)
void
setName(String name)
void
setProperty(String property)
Set the property name.
void
setSize(String size)
void
setValue(String value)
Set the comparison value.

Methods inherited from class org.apache.struts.taglib.html.BaseHandlerTag

doErrorsExist, getAccesskey, getAlt, getAltKey, getBundle, getDisabled, getElementClose, getErrorKey, getErrorStyle, getErrorStyleClass, getErrorStyleId, getIndexValue, getIndexed, getJstlLoopIndex, getLocale, getOnblur, getOnchange, getOnclick, getOndblclick, getOnfocus, getOnkeydown, getOnkeypress, getOnkeyup, getOnmousedown, getOnmousemove, getOnmouseout, getOnmouseover, getOnmouseup, getOnselect, getReadonly, getStyle, getStyleClass, getStyleId, getTabindex, getTitle, getTitleKey, isXhtml, lookupProperty, message, prepareAttribute, prepareEventHandlers, prepareFocusEvents, prepareIndex, prepareKeyEvents, prepareMouseEvents, prepareName, prepareOtherAttributes, prepareStyles, prepareTextEvents, release, setAccesskey, setAlt, setAltKey, setBundle, setDisabled, setErrorKey, setErrorStyle, setErrorStyleClass, setErrorStyleId, setIndexed, setLocale, setOnblur, setOnchange, setOnclick, setOndblclick, setOnfocus, setOnkeydown, setOnkeypress, setOnkeyup, setOnmousedown, setOnmousemove, setOnmouseout, setOnmouseover, setOnmouseup, setOnselect, setReadonly, setStyle, setStyleClass, setStyleId, setTabindex, setTitle, setTitleKey

Field Details

match

protected String[] match
The actual values we will match against, calculated in doStartTag().

messages

protected static MessageResources messages
The message resources for this package.

multiple

protected String multiple
Should multiple selections be allowed. Any non-null value will trigger rendering this.

name

protected String name
The name of the bean containing our underlying property.

property

protected String property
The property name we are associated with.

saveBody

protected String saveBody
The saved body content of this tag.

size

protected String size
How many available options should be displayed when this element is rendered?

value

protected String value
The value to compare with for marking an option selected.

Method Details

calculateMatchValues

private void calculateMatchValues()
            throws JspException
Calculate the match values we will actually be using.

doAfterBody

public int doAfterBody()
            throws JspException
Save any body content of this tag, which will generally be the option(s) representing the values displayed to the user.

doEndTag

public int doEndTag()
            throws JspException
Render the end of this form.

doStartTag

public int doStartTag()
            throws JspException
Render the beginning of this select tag.

Support for indexed property since Struts 1.1


getMultiple

public String getMultiple()

getName

public String getName()

getProperty

public String getProperty()
Return the property name.

getSize

public String getSize()

getValue

public String getValue()
Return the comparison value.

isMatched

public boolean isMatched(String value)
Does the specified value match one of those we are looking for?
Parameters:
value - Value to be compared.

prepareName

protected String prepareName()
            throws JspException
Prepare the name element
Overrides:
prepareName in interface BaseHandlerTag
Returns:
The element name.

release

public void release()
Release any acquired resources.
Overrides:
release in interface BaseHandlerTag

renderSelectStartElement

protected String renderSelectStartElement()
            throws JspException
Create an appropriate select start element based on our parameters.
Since:
Struts 1.1

setMultiple

public void setMultiple(String multiple)

setName

public void setName(String name)

setProperty

public void setProperty(String property)
Set the property name.
Parameters:
property - The new property name

setSize

public void setSize(String size)

setValue

public void setValue(String value)
Set the comparison value.
Parameters:
value - The new comparison value

Copyright B) 2000-2007 - The Apache Software Foundation