UI-Component Sets
Project Documentation


Tag name: <f:selectItems>
UIComponent class: javax.faces.component.UISelectItems
Tag class: org.apache.myfaces.taglib.core.SelectItemsTag
Component type: javax.faces.SelectItems
Component family: javax.faces.SelectItems

This tag associates a set of selection list items with the nearest parent UIComponent. The set of SelectItem objects is retrieved via a value-binding.

Unless otherwise specified, all attributes accept static values or EL expressions.

See Javadoc of JSF Specification


Name Type Supports EL? Description
binding String 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 An identifier for this particular component instance within a component view.

The id must be unique within the scope of the tag's enclosing NamingContainer (eg h:form or f:subview). The id is not necessarily unique across all components in the current view

This value must be a static value, ie not change over the lifetime of a component. It cannot be defined via an EL expression; only a string is permitted.

value Object Yes An EL expression that specifies the contents of the selection list. The expression can refer to one of the following:
  1. A single SelectItem
  2. An array or Collection of SelectItem instances
  3. A Map. The contents of the Map are used to create SelectItem instances, where the SelectItem's label is the map's key value, and the SelectItem's value is the map's value. When using a map, it is recommended that an ordered implementation such as java.util.TreeMap is used.
The value properties of each of the SelectItems must be of the same basic type as the parent component's value.