Summary
Tag name: <f:selectItem>
UIComponent class: javax.faces.component.UISelectItem
Tag class: org.apache.myfaces.taglib.core.SelectItemTag
Component type: javax.faces.SelectItem
Component family: javax.faces.SelectItem
This tag associates a single SelectItem with the nearest parent UIComponent. The item represents a single option for
a component such as an h:selectBooleanCheckbox or h:selectOneMenu. See also component selectItems.
Unless otherwise specified, all attributes accept static values or EL expressions.
UISelectItem should be nestetd inside a UISelectMany or UISelectOne component, and results in the addition of a SelectItem instance to the list of available options for the parent component
Attributes
Name | Type | Supports EL? | Description |
---|---|---|---|
binding | javax.faces.component.UISelectItem | Only EL | Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind " + "to this component instance. This value must be an EL expression. |
id | String | Yes | Get a string which uniquely identifies this UIComponent within the scope of the nearest ancestor NamingContainer component. The id is not necessarily unique across all components in the current view. |
itemDescription | String | Yes | For use in development tools. |
itemDisabled | boolean | Yes | Determine whether this item can be chosen by the user. When true, this item cannot be chosen by the user. If this method is ever called, then any EL-binding for the disabled property will be ignored. |
escape | boolean | Yes | The escape setting for the label of this selection item. |
itemLabel | String | Yes | The string which will be presented to the user for this option. |
itemValue | Object | Yes | The value for this Item. |
noSelectionOption | boolean | Yes | Indicate this component represent no selection option. Default value is false. |
value | Object | Yes | The initial value of this component. |