com.opensymphony.webwork.components
Class ComboBox
java.lang.Object
com.opensymphony.webwork.components.Component
com.opensymphony.webwork.components.UIBean
com.opensymphony.webwork.components.TextField
com.opensymphony.webwork.components.ComboBox
public class ComboBox
- extends TextField
The combo box is basically an HTML INPUT of type text and HTML SELECT grouped together to give you a combo box
functionality. You can place text in the INPUT control by using the SELECT control or type it in directly in
the text field.
In this example, the SELECT will be populated from id=year attribute. Counter is itself an Iterator. It will
span from first to last. The population is done via javascript, and requires that this tag be surrounded by a
<form>.
Note that unlike the <ww:select/> tag, there is no ability to define the individual <option> tags' id attribute
or content separately. Each of these is simply populated from the toString() method of the list item. Presumably
this is because the select box isn't intended to actually submit useful data, but to assist the user in filling
out the text field.
Examples
JSP:
<ww:bean name="webwork.util.Counter" id="year">
<ww:param name="first" value="text('firstBirthYear')"/>
<ww:param name="last" value="2000"/>
<ww:combobox label="Birth year" size="6" maxlength="4" name="birthYear" list="#year"/>
</ww:bean>
Velocity:
#tag( ComboBox "label=Birth year" "size=6" "maxlength=4" "name=birthYear" "list=#year" )
- Since:
- 2.2
- Version:
- $Revision: 2468 $
- Author:
- Patrick Lightbody, Rene Gielen
Fields inherited from class com.opensymphony.webwork.components.UIBean |
accesskey, cssClass, cssStyle, disabled, label, labelPosition, name, onblur, onchange, onclick, ondblclick, onfocus, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup, onselect, request, required, requiredposition, response, tabindex, template, templateDir, templateSuffix, theme, title, tooltip, tooltipConfig, value |
Methods inherited from class com.opensymphony.webwork.components.UIBean |
addFormParameter, buildTemplateName, enableAncestorFormCustomOnsubmit, end, escape, evaluateNameValue, evaluateParams, getTemplate, getTemplateDir, getTheme, getTooltipConfig, getValueClassType, mergeTemplate, populateComponentHtmlId, setAccesskey, setCssClass, setCssStyle, setDisabled, setLabel, setLabelposition, setLabelPosition, setName, setOnblur, setOnchange, setOnclick, setOndblclick, setOnfocus, setOnkeydown, setOnkeypress, setOnkeyup, setOnmousedown, setOnmousemove, setOnmouseout, setOnmouseover, setOnmouseup, setOnselect, setRequired, setRequiredposition, setTabindex, setTemplate, setTemplateDir, setTheme, setTitle, setTooltip, setTooltipConfig, setValue |
Methods inherited from class com.opensymphony.webwork.components.Component |
addAllParameters, addParameter, altSyntax, copyParams, determineActionURL, determineNamespace, end, fieldError, findAncestor, findString, findString, findValue, findValue, findValue, getComponentStack, getId, getParameters, getStack, popComponentStack, setId, start, toString, usesBody |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
TEMPLATE
public static final String TEMPLATE
- See Also:
- Constant Field Values
list
protected String list
ComboBox
public ComboBox(OgnlValueStack stack,
HttpServletRequest request,
HttpServletResponse response)
getDefaultTemplate
protected String getDefaultTemplate()
- Description copied from class:
UIBean
- A contract that requires each concrete UI Tag to specify which template should be used as a default. For
example, the CheckboxTab might return "checkbox.vm" while the RadioTag might return "radio.vm". This value
not begin with a '/' unless you intend to make the path absolute rather than relative to the
current theme.
- Overrides:
getDefaultTemplate
in class TextField
- Returns:
- The name of the template to be used as the default.
evaluateExtraParams
public void evaluateExtraParams()
- Overrides:
evaluateExtraParams
in class TextField
setList
public void setList(String list)
- Iteratable source to populate from. If this is missing, the select widget is simply not displayed.