q
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 Classteamdev.jsf.taglib.TwoListSelectionJspTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredBinding TypeELDefaultDescription
addAllHintfalsejava.lang.Stringtrue"Add all"Text for a tooltip that appears when the user places the mouse pointer over the "Add All" button.
addAllTextfalsejava.lang.Stringtrue"Add All"Text for the "Add All" button.
addHintfalsejava.lang.Stringtrue"Add selected"Text for a tooltip that appears when the user places the mouse pointer over the "Add" button.
addTextfalsejava.lang.Stringtrue"Add"Text for the "Add" button.
allowAddRemoveAllfalsebooleantruetrueA flag that indicates whether or not the "Add All" and "Remove All" buttons are shown.
allowItemsOrderingfalsebooleantruetrueA flag that indicates whether or not the ordering feature is enabled. Ordering is allowed only in the right list.
allowSortingfalsebooleantruefalseA 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.
bindingfalseteamdev.jsf.component.twolistselection.TwoListSelectiononlynullA value-binding expression that associates the TwoListSelection component with a backing bean property.
buttonClassfalsejava.lang.StringtruenullA CSS class name for the TwoListSelection's command buttons.
buttonStylefalsejava.lang.StringtruenullA style for the TwoListSelection's command buttons.
converterfalsejava.lang.StringtruenullA converter for the TwoListSelection's value. Should be specified as a value-binding expression or converter identifier.
headerClassfalsejava.lang.StringtruenullA CSS class name for the TwoListSelection headers.
headerStylefalsejava.lang.StringtruenullA style for the TwoListSelection headers.
idfalsejava.lang.StringfalsenullThe component identifier.
immediatefalsebooleantruefalseA 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).
leftListboxHeaderfalsejava.lang.StringtruenullText for the header of the left list.
listClassfalsejava.lang.StringtruenullA CSS class name for the TwoListSelection list boxes.
listStylefalsejava.lang.StringtruenullA style for the TwoListSelection list boxes.
moveDownHintfalsejava.lang.Stringtrue"Move Down"Text for a tooltip that appears when the user places the mouse pointer over the "Down" button.
moveDownTextfalsejava.lang.Stringtrue"Down"Text for the "Down" button.
moveUpHintfalsejava.lang.Stringtrue"Move Up"Text for a tooltip that appears when the user places the mouse pointer over the "Up" button.
moveUpTextfalsejava.lang.Stringtrue"Up"Text for the "Up" button.
onaddfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when an item(s) is added to the selected list.
onremovefalsejava.lang.StringtruenullJavaScript code that should be executed on the client when an item(s) is removed from the selected list.
removeAllHintfalsejava.lang.Stringtrue"Remove all"Text for a tooltip that appears when the user places the mouse pointer over the "Remove All" button.
removeAllTextfalsejava.lang.Stringtrue"Remove All"Text for the "Remove All" button.
removeHintfalsejava.lang.Stringtrue"Remove selected"Text for a tooltip that appears when the user places the mouse pointer over the "Remove" button.
removeTextfalsejava.lang.Stringtrue"Remove"Text for the "Remove" button.
renderedfalsebooleantruetrueA flag that indicates whether or not the component is visible.
requiredfalsebooleantruefalseA flag that indicates whether or not the TwoListSelection requires a value.
rightListboxHeaderfalsejava.lang.StringtruenullText for the header of the right list.
sizefalseinttrue10The maximum number of items to be displayed at a time in the lists.
stylefalsejava.lang.StringtruenullA style for the entire TwoListSelection component.
styleClassfalsejava.lang.StringtruenullA CSS class name for the entire TwoListSelection component.
validatorfalsejavax.faces.el.MethodBindingonlynullA MethodBinding that should point to the method in the backing bean that is called to validate the TwoListSelection's value.
valuefalselist of Object,
array of Object
onlynullA list of selected items in the TwoListSelection.
valueChangeListenerfalsejavax.faces.el.MethodBindingonlynullA 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.