The <r:select> component provides a drop-down list box for selecting a single value from multiple options. The <r:select> component can be configured as a combo-box, where it will accept typed input. The component also supports keyboard navigation. The <r:select> component functions similarly to the JSF UISelectOne component.
@author abelevich| Info | Value |
|---|---|
| Component Type | org.richfaces.ui.Select |
| Display Name | None |
| Handler Class | None |
| Renderer Type | org.richfaces.ui.SelectRenderer |
| Description | The <r:select> component provides a drop-down list box for selecting a single value from multiple options. The <r:select> component can be configured as a combo-box, where it will accept typed input. The component also supports keyboard navigation. The <r:select> component functions similarly to the JSF UISelectOne component. @author abelevich |
| Name | Required | Type | Description |
|---|---|---|---|
binding |
false
| javax.el.ValueExpression
(must evaluate to javax.faces.component.UIComponent)
| The value binding expression used to wire up this component to a component property of a JavaBean class |
clientFilterFunction |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| A javascript function used to filter the list of items in the select popup |
converter |
false
| javax.el.ValueExpression
(must evaluate to javax.faces.convert.Converter)
| Converter instance registered with this component. |
converterMessage |
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
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Used to set the display text when value is undefined |
disabled |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If "true", this component is disabled |
enableManualInput |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If "true" Allows the user to type into a text field to scroll through or filter the list Default is "false" |
id |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The component identifier for this component. This value must be unique within the closest parent component that is a naming container. |
immediate |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| Flag indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase. |
itemClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) to be applied to the list items. This value must be passed through as the "class" attribute on generated markup. |
listClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) to be applied to the list element. This value must be passed through as the "class" attribute on generated markup. |
listHeight |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The height of the list element (in pixels) |
listWidth |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The width of the list element (in pixels) |
maxListHeight |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The maximum height of the list |
minListHeight |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The minimum height ot the list |
onblur |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when this element loses focus. |
onchange |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when the list element loses focus and its value has been modified since gaining focus. |
onclick |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is clicked over this element. |
ondblclick |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is double clicked over this element. |
onfocus |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when this element receives focus. |
onkeydown |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is pressed down over this element. |
onkeypress |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is pressed and released over this element. |
onkeyup |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is released over this element. |
onlistclick |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is clicked over the list element. |
onlistdblclick |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is double clicked over the list element. |
onlisthide |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when the list element is hidden |
onlistkeydown |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is pressed down over the list element. |
onlistkeypress |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is pressed and released over the list element. |
onlistkeyup |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is released over the list element. |
onlistmousedown |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is pressed down over the list element. |
onlistmousemove |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved within the list element. |
onlistmouseout |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved away from the list element. |
onlistmouseover |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved onto the list element. |
onlistmouseup |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is released over the list element. |
onlistshow |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when the list element is shown |
onmousedown |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is pressed down over this element. |
onmousemove |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved within this element. |
onmouseout |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved away from this element. |
onmouseover |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved onto this element. |
onmouseup |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is released over this element. |
onselectitem |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when an item is selected |
rendered |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true. |
required |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| Flag indicating that the user is required to provide a submitted value for this input component. |
requiredMessage |
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. |
selectFirst |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If "true" as the user types to narrow the list, automatically select the first element in the list. Applicable only when enableManualInput is "true". Default is "true" |
selectItemClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) to be applied to the selected list item. This value must be passed through as the "class" attribute on generated markup. |
showButton |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| When "true" display a button to expand the popup list Default is "true" |
style |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| CSS style(s) to be applied when this component is rendered. |
styleClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup. |
tabindex |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767. |
title |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Advisory title information about markup elements generated for this component. |
validator |
false
| javax.el.ValueExpression
(must evaluate to javax.faces.el.MethodBinding)
| MethodExpression representing a validator method that will be called during Process Validations to perform correctness checks on the value of this component. The expression must evaluate to a public method that takes FacesContext, UIComponent, and Object parameters, with a return type of void. |
validatorMessage |
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
| javax.el.ValueExpression
(must evaluate to java.lang.Object)
| The current value of this component. |
valueChangeListener |
false
| javax.el.ValueExpression
(must evaluate to javax.faces.el.MethodBinding)
| MethodExpression representing a value change listener method that will be notified when a new value has been set for this input component. The expression must evaluate to a public method that takes a |
Output generated by Vdldoc View Declaration Language Documentation Generator.