q
Tag dropDownField


Renders the DropDownField component that represents a text field with a set of predefined values in the drop-down list.
There are two ways to specify items in the drop-down list: These two approaches can be combined in any order.


Tag Information
Tag Classteamdev.jsf.taglib.DropDownFieldJspTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredBinding TypeELDefaultDescription
bindingfalseteamdev.jsf.component.dropdown.DropDownFieldonlynullA value-binding expression that associates the DropDownField with a backing bean property.
buttonAlignmentfalseteamdev.jsf.component.dropdown.HorizontalAlignmenttrue"right"Defines whether the button that opens the drop-down list is positioned to the right or to the left of the text field.
Available values are:
"left"
"right"
buttonClassfalsejava.lang.StringtruenullA CSS class name for for the drop-down button.
buttonImageUrlfalsejava.lang.StringtruenullURL to the image file for the drop-down button.
buttonStylefalsejava.lang.StringtruenullA style for the drop-down button.
converterfalsejava.lang.StringtruenullA converter for the DrowDownField's value. Should be specified as a value-binding expression or converter identifier.
fieldClassfalsejava.lang.StringtruenullA CSS class name for the text field.
fieldStylefalsejava.lang.StringtruenullA style for the text field.
idfalsejava.lang.StringfalsenullThe component identifier.
immediatefalsebooleantruefalseA flag that indicates whether or not 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).
listAlignmentfalseteamdev.jsf.component.dropdown.HorizontalAlignmenttrue"left"Defines how items in the drop-down list are aligned.
Available values are:
"left"
"right"
listClassfalsejava.lang.StringtruenullA CSS class name for the drop-down list.
listItemClassfalsejava.lang.StringtruenullA CSS class name for a list item.
listItemStylefalsejava.lang.StringtruenullA style for a list item.
listStylefalsejava.lang.StringtruenullA style for the drop-down list.
onblurfalsejava.lang.StringtruenullJavaScript code that should be executed when the DropDownField loses focus.
onchangefalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the DropDownField's value has changed.
onclickfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user clicks the left mouse button over the DropDownField.
oncloseupfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the drop-down list has closed.
ondblclickfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user double-clicks the left mouse button over the DropDownField.
ondropdownfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the drop-down list has opened.
onfocusfalsejava.lang.StringtruenullJavaScript code that should be executed when the DropDownField receives focus.
onkeydownfalsejava.lang.StringnonenoneJavaScript code that should be executed when the user presses a key over the DropDownField.
onkeypressfalsejava.lang.StringtruenullJavaScript code that should be executed on the client when the user presses and releases a key over the DropDownField.
onkeyupfalsejava.lang.StringtruenullJavaScript code that should be executed when the user releases a key over the DropDownField.
onmousedownfalsejava.lang.StringtruenullJavaScript code that should be executed when the user clicks over the DropDownField with either mouse button.
onmousemovefalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer over the DropDownField.
onmouseoutfalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer away from the DropDownField.
onmouseoverfalsejava.lang.StringtruenullJavaScript code that should be executed when the user moves the mouse pointer onto the DropDownField.
onmouseupfalsejava.lang.StringtruenullJavaScript code that should be executed when the user releases the mouse button over the DropDownField.
pressedButtonClassfalsejava.lang.StringtruenullA CSS class name for the drop-down button in the pressed state.
pressedButtonStylefalsejava.lang.StringtruenullA style for the drop-down button in the pressed state.
renderedfalsebooleantruefalseA flag that indicates whether or not the component is visible.
requiredfalsebooleantruefalseA flag that indicates whether or not the DropDownField requires a value.
rolloverButtonClassfalsejava.lang.StringtruenullA CSS class name for the drop-down button in the rollover state.
rolloverButtonStylefalsejava.lang.StringtruenullA style for the drop-down button in the rollover state.
rolloverClassfalsejava.lang.StringtruenullA CSS class name for the entire DropDownField component in the rollover state.
rolloverFieldClassfalsejava.lang.StringtruenullA CSS class name for the text field in the rollover state.
rolloverFieldStylefalsejava.lang.StringtruenullA style for the text field in the rollover state.
rolloverListClassfalsejava.lang.StringtruenullA CSS class name for the drop-down list in the rollover state.
rolloverListItemClassfalsejava.lang.StringtruenullA CSS class name for a list item in the rollover state.
rolloverListItemStylefalsejava.lang.StringtruenullA style for a list item in the rollover state.
rolloverListStylefalsejava.lang.StringtruenullA style for the drop-down list in the rollover state.
rolloverStylefalsejava.lang.StringtruenullA style for the entire DropDownField component in the rollover state.
stylefalsejava.lang.StringtruenullA style for the entire DropDownField component.
styleClassfalsejava.lang.StringtruenullA CSS class name for the entire DropDownField component.
timeoutfalseinttrue-1A time period after which the drop-down list is closed automatically. The value "-1" means that the list will not close automatically.
validatorfalsejavax.faces.el.MethodBindingonlynullA MethodBinding that should point to the method in the backing bean that is called to validate the DropDownField's value.
valuefalsejava.lang.StringtruenullThe value that is displayed in the text field.
valueChangeListenerfalsejavax.faces.el.MethodBindingonlynullA MethodBinding that should point to the method that accepts a ValueChangeEvent. If the value of the DropDownField 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.