UI-Component Sets
Project Documentation


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


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.
value Object Yes The initial value of this component.