org.apache.struts2.components
Class UpDownSelect

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

public class UpDownSelect
extends Select

Create a Select component with buttons to move the elements in the select component up and down. When the containing form is submited, its elements will be submitted in the order they are arranged (top to bottom).

 

 <!-- Example 1: simple example -->
 <s:updownselect
 list="#{'england':'England', 'america':'America', 'germany':'Germany'}"
 name="prioritisedFavouriteCountries"
 headerKey="-1"
 headerValue="--- Please Order Them Accordingly ---"
 emptyOption="true" />

 <!-- Example 2: more complex example -->
 <s:updownselect
 list="defaultFavouriteCartoonCharacters"
 name="prioritisedFavouriteCartoonCharacters"
 headerKey="-1"
 headerValue="--- Please Order ---"
 emptyOption="true"
 allowMoveUp="true"
 allowMoveDown="true"
 allowSelectAll="true"
 moveUpLabel="Move Up"
 moveDownLabel="Move Down"
 selectAllLabel="Select All" />

 
 

Version:

$Date: 2008-04-27 08:41:38 -0500 (Sun, 27 Apr 2008) $ $Id: UpDownSelect.java 651946 2008-04-27 13:41:38Z apetrelli $

Field Summary

protected String	allowMoveDown
protected String	allowMoveUp
protected String	allowSelectAll
private static Logger	LOG
protected String	moveDownLabel
protected String	moveUpLabel
protected String	selectAllLabel
static String	TEMPLATE

Fields inherited from class org.apache.struts2.components.Select

emptyOption, headerKey, headerValue, multiple, size

Fields inherited from class org.apache.struts2.components.ListUIBean

list, listKey, listValue, throwExceptionOnNullValueAttribute

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

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

Fields inherited from class org.apache.struts2.components.Component

actionMapper, COMPONENT_STACK, parameters, stack

Constructor Summary

UpDownSelect(ValueStack stack, HttpServletRequest request, HttpServletResponse response)

Method Summary

void	evaluateParams()
String	getAllowMoveDown()
String	getAllowMoveUp()
String	getAllowSelectAll()
String	getDefaultTemplate() A contract that requires each concrete UI Tag to specify which template should be used as a default.
String	getMoveDownLabel()
String	getMoveUpLabel()
String	getSelectAllLabel()
void	setAllowMoveDown(String allowMoveDown)
void	setAllowMoveUp(String allowMoveUp)
void	setAllowSelectAll(String allowSelectAll)
void	setMoveDownLabel(String moveDownLabel)
void	setMoveUpLabel(String moveUpLabel)
void	setSelectAllLabel(String selectAllLabel)

Methods inherited from class org.apache.struts2.components.Select

evaluateExtraParams, setEmptyOption, setHeaderKey, setHeaderValue, setMultiple, setSize

Methods inherited from class org.apache.struts2.components.ListUIBean

contains, getValueClassType, setList, setListKey, setListValue, setThrowExceptionOnNullValueAttribute

Methods inherited from class org.apache.struts2.components.UIBean

addFormParameter, buildTemplateName, enableAncestorFormCustomOnsubmit, end, ensureAttributeSafelyNotEscaped, escape, evaluateNameValue, getId, getTemplate, getTemplateDir, getTheme, getTooltipConfig, mergeTemplate, populateComponentHtmlId, setAccesskey, setCssClass, setCssErrorClass, setCssErrorStyle, setCssStyle, setDefaultTemplateDir, setDefaultUITheme, setDisabled, setDynamicAttributes, setId, setJavascriptTooltip, setKey, setLabel, setLabelposition, setLabelSeparator, 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 inherited from class org.apache.struts2.components.Component

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

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final Logger LOG

TEMPLATE

public static final String TEMPLATE

See Also:

Constant Field Values

allowMoveUp

protected String allowMoveUp

allowMoveDown

protected String allowMoveDown

allowSelectAll

protected String allowSelectAll

moveUpLabel

protected String moveUpLabel

moveDownLabel

protected String moveDownLabel

selectAllLabel

protected String selectAllLabel

Constructor Detail

UpDownSelect

public UpDownSelect(ValueStack stack,
                    HttpServletRequest request,
                    HttpServletResponse response)

Method Detail

getDefaultTemplate

public 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 Select

Returns:

The name of the template to be used as the default.

evaluateParams

public void evaluateParams()

Overrides:

evaluateParams in class UIBean

getAllowMoveUp

public String getAllowMoveUp()

setAllowMoveUp

public void setAllowMoveUp(String allowMoveUp)

getAllowMoveDown

public String getAllowMoveDown()

setAllowMoveDown

public void setAllowMoveDown(String allowMoveDown)

getAllowSelectAll

public String getAllowSelectAll()

setAllowSelectAll

public void setAllowSelectAll(String allowSelectAll)

getMoveUpLabel

public String getMoveUpLabel()

setMoveUpLabel

public void setMoveUpLabel(String moveUpLabel)

getMoveDownLabel

public String getMoveDownLabel()

setMoveDownLabel

public void setMoveDownLabel(String moveDownLabel)

getSelectAllLabel

public String getSelectAllLabel()

setSelectAllLabel

public void setSelectAllLabel(String selectAllLabel)