Home » struts-2.1.8.1-src » org.apache » struts2 » components » [javadoc | source]

org.apache.struts2.components
public class: Select [javadoc | source]

java.lang.Object
   org.apache.struts2.components.Component
      org.apache.struts2.components.UIBean
         org.apache.struts2.components.ListUIBean
            org.apache.struts2.components.Select

Direct Known Subclasses:
    UpDownSelect

Render an HTML input tag of type select.

Examples

<s:select label="Pets"
       name="petIds"
       list="petDao.pets"
       listKey="id"
       listValue="name"
       multiple="true"
       size="3"
       required="true"
       value="%{petDao.pets.{id}}"
/>

<s:select label="Months"
       name="months"
       headerKey="-1" headerValue="Select Month"
       list="#{'01':'Jan', '02':'Feb', [...]}"
       value="selectedMonth"
       required="true"
/>

// The month id (01, 02, ...) returned by the getSelectedMonth() call
// against the stack will be auto-selected

Note: For any of the tags that use lists (select probably being the most ubiquitous), which uses the OGNL list notation (see the "months" example above), it should be noted that the map key created (in the months example, the '01', '02', etc.) is typed. '1' is a char, '01' is a String, "1" is a String. This is important since if the value returned by your "value" attribute is NOT the same type as the key in the "list" attribute, they WILL NOT MATCH, even though their String values may be equivalent. If they don't match, nothing in your list will be auto-selected.

Field Summary
public static final  String	TEMPLATE
protected  String	emptyOption
protected  String	headerKey
protected  String	headerValue
protected  String	multiple
protected  String	size

Fields inherited from org.apache.struts2.components.ListUIBean:
list,  listKey,  listValue,  throwExceptionOnNullValueAttribute

Fields inherited from org.apache.struts2.components.UIBean:

request,  response,  templateSuffix,  template,  templateDir,  theme,  key,  id,  cssClass,  cssStyle,  cssErrorClass,  cssErrorStyle,  disabled,  label,  labelPosition,  labelSeparator,  requiredposition,  name,  required,  tabindex,  value,  title,  onclick,  ondblclick,  onmousedown,  onmouseup,  onmouseover,  onmousemove,  onmouseout,  onfocus,  onblur,  onkeypress,  onkeydown,  onkeyup,  onselect,  onchange,  accesskey,  tooltip,  tooltipConfig,  javascriptTooltip,  tooltipDelay,  tooltipCssClass,  tooltipIconPath,  dynamicAttributes,  defaultTemplateDir,  defaultUITheme,  templateEngineManager

Fields inherited from org.apache.struts2.components.Component:
COMPONENT_STACK,  stack,  parameters,  actionMapper,  throwExceptionOnELFailure

Constructor:
public Select(ValueStack stack, HttpServletRequest request, HttpServletResponse response) { super(stack, request, response); }

Method from org.apache.struts2.components.Select Summary:
evaluateExtraParams,   getDefaultTemplate,   setEmptyOption,   setHeaderKey,   setHeaderValue,   setMultiple,   setSize

Methods from org.apache.struts2.components.ListUIBean:
contains,   evaluateExtraParams,   getValueClassType,   setList,   setListKey,   setListValue,   setThrowExceptionOnNullValueAttribute

Methods from org.apache.struts2.components.UIBean:

addFormParameter,   buildTemplateName,   enableAncestorFormCustomOnsubmit,   end,   ensureAttributeSafelyNotEscaped,   escape,   evaluateExtraParams,   evaluateNameValue,   evaluateParams,   getDefaultTemplate,   getId,   getTemplate,   getTemplateDir,   getTheme,   getTooltipConfig,   getValueClassType,   mergeTemplate,   populateComponentHtmlId,   setAccesskey,   setCssClass,   setCssErrorClass,   setCssErrorStyle,   setCssStyle,   setDefaultTemplateDir,   setDefaultUITheme,   setDisabled,   setDynamicAttributes,   setId,   setJavascriptTooltip,   setKey,   setLabel,   setLabelSeparator,   setLabelposition,   setName,   setOnblur,   setOnchange,   setOnclick,   setOndblclick,   setOnfocus,   setOnkeydown,   setOnkeypress,   setOnkeyup,   setOnmousedown,   setOnmousemove,   setOnmouseout,   setOnmouseover,   setOnmouseup,   setOnselect,   setRequired,   setRequiredposition,   setTabindex,   setTemplate,   setTemplateDir,   setTemplateEngineManager,   setTheme,   setTitle,   setTooltip,   setTooltipConfig,   setTooltipCssClass,   setTooltipDelay,   setTooltipIconPath,   setValue

Methods from org.apache.struts2.components.Component:

addAllParameters,   addParameter,   altSyntax,   altSyntax,   completeExpressionIfAltSyntax,   copyParams,   determineActionURL,   determineNamespace,   end,   end,   fieldError,   findAncestor,   findString,   findString,   findStringIfAltSyntax,   findValue,   findValue,   findValue,   getComponentStack,   getParameters,   getStack,   popComponentStack,   setActionMapper,   setThrowExceptionsOnELFailure,   start,   stripExpressionIfAltSyntax,   stripExpressionIfAltSyntax,   toString,   usesBody

Methods from java.lang.Object:
clone,   equals,   finalize,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait

Method from org.apache.struts2.components.Select Detail:
public void evaluateExtraParams() { super.evaluateExtraParams(); if (emptyOption != null) { addParameter("emptyOption", findValue(emptyOption, Boolean.class)); } if (multiple != null) { addParameter("multiple", findValue(multiple, Boolean.class)); } if (size != null) { addParameter("size", findString(size)); } if ((headerKey != null) && (headerValue != null)) { addParameter("headerKey", findString(headerKey)); addParameter("headerValue", findString(headerValue)); } }
protected String getDefaultTemplate() { return TEMPLATE; }
public void setEmptyOption(String emptyOption) { this.emptyOption = emptyOption; }
public void setHeaderKey(String headerKey) { this.headerKey = headerKey; }
public void setHeaderValue(String headerValue) { this.headerValue = headerValue; }
public void setMultiple(String multiple) { this.multiple = multiple; }
public void setSize(String size) { this.size = size; }