o
Tag twoListSelection


The TwoListSelection component serves the same purpose as the standard HtmlSelectManyListbox in JSF, but has a different appearance and provides a number of extra features. It consists of two list boxes separated by a set of buttons that let the user move selected items from one list to the other and reorder the selected items. The list on the left contains available items which the user can add to (or from) the list on the right in order to make a selection.


Tag Information
Tag Classorg.openfaces.taglib.jsp.select.TwoListSelectionJspTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredBinding TypeELDefaultDescription
addAllHintfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Add all"Text for a tooltip that appears when the user places the mouse pointer over the "Add All" button.
addAllTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Add All"Text for the "Add All" button.
addHintfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Add selected"Text for a tooltip that appears when the user places the mouse pointer over the "Add" button.
addTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Add"Text for the "Add" button.
allowAddRemoveAllfalsejavax.el.ValueExpression
(must evaluate to boolean)
truetrueA flag that indicates whether or not the "Add All" and "Remove All" buttons are shown.
bindingfalsejavax.el.ValueExpression
(must evaluate to org.openfaces.component.select.TwoListSelection)
onlynullA value-binding expression that associates the TwoListSelection component with a backing bean property.
buttonClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the TwoListSelection's command buttons.
buttonStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the TwoListSelection's command buttons.
converterfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA converter for the TwoListSelection's value. Should be specified as a value-binding expression or converter identifier.
disabledfalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that enables or disables the component.
disabledButtonClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the TwoListSelection's command buttons in the disabled state.
disabledButtonStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the TwoListSelection's command buttons in the disabled state.
disabledClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the entire TwoListSelection component in the disabled state.
disabledHeaderClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the TwoListSelection headers in the disabled state.
disabledHeaderStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the TwoListSelection headers in the disabled state.
disabledListClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the TwoListSelection list boxes in the disabled state.
disabledListStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the TwoListSelection list boxes in the disabled state.
disabledStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the entire TwoListSelection component in the disabled state.
headerClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the TwoListSelection headers.
headerStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the TwoListSelection headers.
idfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
falsenullThe component identifier.
immediatefalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that indicates whether or not the valueChangeListener should be executed immediately (during the Apply Request Values phase of the request processing lifecycle instead of Process Validations phase) and the component's input should be converted and validated immediately (during the Apply Request Values phase of the request processing lifecycle instead of the Process Validations phase).
labelfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA localized user presentable name for this component. Used when constructing validation messages for this component in the same way as for the standard component.
leftListboxHeaderfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullText for the header of the left list.
listClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the TwoListSelection list boxes.
listStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the TwoListSelection list boxes.
moveDownHintfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Move Down"Text for a tooltip that appears when the user places the mouse pointer over the "Down" button.
moveDownTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Down"Text for the "Down" button.
moveUpHintfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Move Up"Text for a tooltip that appears when the user places the mouse pointer over the "Up" button.
moveUpTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Up"Text for the "Up" button.
onaddfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when an item(s) is added to the selected list.
onchangefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when an item(s) is added or removed to/from the selected list.
onclickfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when the user clicks the left mouse button over the TwoListSelection.
oncontextmenufalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user presses right mouse button over the component (or performs the other context menu invocation action depending on the platform).
ondblclickfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when the user double-clicks the left mouse button over the TwoListSelection.
onkeydownfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user presses a key over the TwoListSelection.
onkeypressfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when the user presses and releases a key over the TwoListSelection.
onkeyupfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user releases a key over the TwoListSelection.
onmousedownfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user clicks over the TwoListSelection with either mouse button.
onmousemovefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user moves the mouse pointer over the TwoListSelection.
onmouseoutfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user moves the mouse pointer away from the TwoListSelection.
onmouseoverfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user moves the mouse pointer onto the TwoListSelection.
onmouseupfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user releases a mouse button over the TwoListSelection.
onremovefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when an item(s) is removed from the selected list.
removeAllHintfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Remove all"Text for a tooltip that appears when the user places the mouse pointer over the "Remove All" button.
removeAllTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Remove All"Text for the "Remove All" button.
removeHintfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Remove selected"Text for a tooltip that appears when the user places the mouse pointer over the "Remove" button.
removeTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Remove"Text for the "Remove" button.
renderedfalsejavax.el.ValueExpression
(must evaluate to boolean)
truetrueA flag that indicates whether or not the component is visible.
reorderingAllowedfalsejavax.el.ValueExpression
(must evaluate to boolean)
truetrueA flag that indicates whether or not the ordering feature is enabled. Ordering is allowed only in the right list.
requiredfalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that indicates whether or not the TwoListSelection requires a value.
rightListboxHeaderfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullText for the header of the right list.
rolloverClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the TwoListSelection component in the rollover state.
rolloverStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the TwoListSelection component in the rollover state.
sizefalsejavax.el.ValueExpression
(must evaluate to int)
true10The maximum number of items to be displayed at a time in the lists.
sortingAllowedfalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that indicates whether or not sorting is enabled. Sorting is allowed only in the right list. This attribute makes sense only if the text to be displayed in the header of the right list is specified.
stylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the entire TwoListSelection component.
styleClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the entire TwoListSelection component.
tabindexfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullPosition of the component in the focus transition chain for the current document.
validatorfalsejavax.el.MethodExpression
(signature must match void validate(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.Object))
onlynullA MethodBinding that should point to the method in the backing bean that is called to validate the TwoListSelection's value.
valuefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
onlynullA list of selected items in the TwoListSelection.
valueChangeListenerfalsejavax.el.MethodExpression
(signature must match void valueChange(javax.faces.event.ValueChangeEvent))
onlynullA MethodBinding that should point to the method that accepts a ValueChangeEvent. If the value of the TwoListSelection changes, this method is executed.

Variables
No Variables Defined.


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.