Overview | Library | Tag | Help
| FRAMES NO FRAMES

## RichFaces
Tag listShuttle

The <rich:listShuttle> component is used for moving chosen items from one list into another with their optional reordering there.

Tag Information
Tag Class | org.richfaces.taglib.ListShuttleTag
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
activeItem | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | Stores active item
ajaxKeys | false | false | `javax.el.ValueExpression` (must evaluate to `java.util.Set`) | Defines row keys that are updated after an Ajax request
binding | false | false | `javax.el.ValueExpression` (must evaluate to `javax.faces.component.UIComponent`) | The attribute takes a value-binding expression for a component property of a backing bean
bottomControlClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for bottom control
bottomControlLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines a label for a bottom control
columnClasses | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Comma-separated list of CSS classes for columns
componentState | false | false | `javax.el.ValueExpression` (must evaluate to `org.ajax4jsf.model.DataComponentState`) | It defines EL-binding for a component state for saving or redefinition
controlsType | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines type of a control: button or none. Default value is "button".
controlsVerticalAlign | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Customizes vertically a position of move/copy and order controls relatively to lists
converter | false | false | `javax.el.ValueExpression` (must evaluate to `javax.faces.convert.Converter`) | Id of Converter to be used or reference to a Converter
copyAllControlClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for copy all control
copyAllControlLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines a label for a copyAll control
copyControlClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for copy control
copyControlLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines a label for a copy control
disabledControlClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for a disabled control
downControlClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for down control
downControlLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines a label for a down control
fastMoveControlsVisible | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | If "false", 'Copy All' and 'Remove All' controls aren't displayed. Default value is "true".
fastOrderControlsVisible | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | If "false", 'Top' and 'Bottom' controls aren't displayed. Default value is "true".
first | false | false | `javax.el.ValueExpression` (must evaluate to `int`) | A zero-relative row number of the first row to display
id | false | false | `java.lang.String` | Every component may have a unique id that is automatically created if omitted
immediate | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | A flag indicating that this component value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until a Process Validations phase
listClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for a list
listsHeight | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines height of the list. Default value is "140".
moveControlsVisible | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | If "false", 'Copy' and 'Remove' controls aren't displayed. Default value is "true".
onblur | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; the element lost the focus
onbottomclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A JavaScript event handler; a button "Bottom" is clicked
onclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer button is clicked
oncopyallclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A JavaScript event handler; a button "Copy All" is clicked
oncopyclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a button "Copy" is clicked
ondblclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer button is double-clicked
ondownclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A JavaScript event handler; a button "Down" is clicked
onfocus | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; the element got the focus
onlistchanged | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A JavaScript event handler called on a list change operation
onmousemove | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer is moved within
onmouseout | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer is moved away
onmouseover | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer is moved onto
onorderchanged | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; called after ordering action
onremoveallclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A JavaScript event handler; a button "Remove All" is clicked
onremoveclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A JavaScript event handler; a button "Remove" is clicked
ontopclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A JavaScript event handler; a button "Top" is clicked
onupclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a button "Up" is clicked
orderControlsVisible | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | If "false", 'Up' and 'Down' controls aren't displayed. Default value is "true".
removeAllControlClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for remove all control
removeAllControlLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines a label for a removeAll control
removeControlClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for remove control
removeControlLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines a label for a remove control
rendered | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | If "false", this component is not rendered
required | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | If "true", this component is checked for non-empty input
rowClasses | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for a row
rowKeyConverter | false | false | `javax.el.ValueExpression` (must evaluate to `javax.faces.convert.Converter`) | Converter for a row key object
rowKeyVar | false | false | `java.lang.String` | The attribute provides access to a row key in a Request scope
rows | false | false | `javax.el.ValueExpression` (must evaluate to `int`) | A number of rows to display, or zero for all remaining rows in the table
showButtonLabels | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | Shows a label for a button. Default value is "true".
sourceCaptionLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines source list caption representation text
sourceListWidth | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines width of a source list. Default value is "140".
sourceRequired | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | Defines the case when source value is being validated. If the value is "true", there should be at least one item in the source list
sourceSelection | false | false | `javax.el.ValueExpression` (must evaluate to `java.util.Set`) | Manages selection in a source list from the server side
sourceValue | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | Defines a List or Array of items to be shown in a source list
style | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style(s) is/are to be applied when this component is rendered
styleClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Corresponds to the HTML class attribute
switchByClick | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | If "true", dragging between lists realized by click
targetCaptionLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines target list caption representation text
targetListWidth | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines width of a target list. Default value is "140".
targetRequired | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | Defines the case when target value is being validated. If the value is "true", there should be at least one item in the target list
targetSelection | false | false | `javax.el.ValueExpression` (must evaluate to `java.util.Set`) | Manages selection in a target list from the server side
targetValue | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | Defines a List or Array of items to be shown in a target list
topControlClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for top control
topControlLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines a label for a "Top" control
upControlClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS class for up control
upControlLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines a label for an "Up" control
validator | false | false | `javax.el.MethodExpression` (signature must match `void validator(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.Object)`) | MethodBinding pointing at a method that is called during Process Validations phase of the request processing lifecycle, to validate the current value of this component
valueChangeListener | false | false | `javax.el.MethodExpression` (signature must match `void valueChangeListener(javax.faces.event.ValueChangeEvent)`) | Listener for value changes
var | false | false | `java.lang.String` | Defines a list on the page

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.