comboBox (RichFaces JSF components library Tag library documentation)
Keywords: $title

Overview | Library | Tag | Help
| FRAMES NO FRAMES

## RichFaces
Tag comboBox

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

Attributes
Name | Required | Request-time | Type | Description
accesskey | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | This attribute assigns an access key to an element. An access key is a single character from the document character set. Note: Authors should consider the input method of the expected reader when specifying an accesskey
align | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | left|center|right|justify [CI] Deprecated. This attribute specifies the horizontal alignment of its element with respect to the surrounding context. Possible values: * left: text lines are rendered flush left. * center: text lines are centered. * right: text lines are rendered flush right. * justify: text lines are justified to both margins. The default depends on the base text direction. For left to right text, the default is align=left, while for right to left text, the default is align=right
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
buttonClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Style Class attribute for the button
buttonDisabledClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Style Class attribute for the disabled button
buttonDisabledStyle | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style rules to be applied to disabled button
buttonIcon | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines icon for the button element
buttonIconDisabled | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines disabled icon for the button element
buttonIconInactive | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines inactive icon for the button element
buttonInactiveClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Style Class attribute for the inactive button
buttonInactiveStyle | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style rules to be applied to inactive button
buttonStyle | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style rules to be applied to button
converter | false | false | `javax.el.ValueExpression` (must evaluate to `javax.faces.convert.Converter`) | Id of Converter to be used or reference to a Converter
converterMessage | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A ValueExpression enabled attribute that, if present, will be used as the text of the converter message, replacing any message that comes from the converter
defaultLabel | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines default label for the input field element
directInputSuggestions | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`) | Defines the first value from the suggested in input field. Default value is "false".
disabled | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | When set for a form control, this boolean attribute disables the control for your input
enableManualInput | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | Enables keyboard input, if "false" keyboard input will be locked. Default value is "true"
filterNewValues | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`) | Defines the appearance of values in the list. Default value is "true".
hideDelay | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Integer`) | Delay between losing focus and pop-up list closing. Default value is "0".
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
inputClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Style Class attribute for the input field
inputDisabledClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Style Class attribute for the disabled input
inputDisabledStyle | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style rules to be applied to disabled input
inputInactiveClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Style Class attribute for the inactive input
inputInactiveStyle | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style rules to be applied to inactive input
inputStyle | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style rules to be applied to input field
itemClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Style Class attribute for the items
itemSelectedClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Style Class attribute for the selected item
listClass | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Style Class attribute for the popup list
listHeight | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines height of file pop-up list. Default value is "200px".
listStyle | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | CSS style rules to be applied to popup list
listWidth | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Defines width of file popup list
onblur | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; the element lost the focus
onchange | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; the element value was changed
onclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer button is clicked
ondblclick | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a pointer button is double-clicked
onfocus | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; the element got the focus
onkeydown | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a key is pressed down
onkeypress | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a key is pressed and released
onkeyup | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: a script expression; a key is released
onlistcall | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A JavaScript event handler called on a list call operation
onmousedown | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; a pointer button is pressed down
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
onmouseup | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; a pointer button is released
onselect | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | HTML: script expression; The onselect event occurs when you select some text in a text field. This attribute may be used with the INPUT and TEXTAREA elements
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
requiredMessage | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A ValueExpression enabled attribute that, if present, will be used as the text of the validation message for the "required" facility, if the "required" facility is used
selectFirstOnUpdate | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Boolean`) | Defines if the first value from suggested is selected in pop-up list. Default value is "true".
showDelay | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Integer`) | Delay between event and pop-up list showing. Default value is "0".
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
suggestionValues | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | Defines the suggestion collection
tabindex | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | This attribute specifies the position of the current element in the tabbing order for the current document. This value must be a number between 0 and 32767. User agents should ignore leading zeros
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
validatorMessage | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | A ValueExpression enabled attribute that, if present, will be used as the text of the validator message, replacing any message that comes from the validator
value | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.Object`) | 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
width | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | Width of the component. Default value is "150".

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.