Component that only renders a subset of its children components. Provides functionality that the JSTL choose tag has, but leverages the {@link javax.faces.component.UIComponent#isRendered()} method instead of using when tags with test attributes.
It can either use a filter type of "count" or "index". If count, the given number of children will be rendered (so for example, a value of 2 will cause the first two children that are have a true isRendered result to be rendered. If index, it will render the given indexes.
| Attributes |
| Name | Required | Request-time | Type | Description |
| type | false | false | javax.el.ValueExpression
(must evaluate to java.lang.Object)
| The filter type: count|index. count: the value should evaluate to a Number or a value that can be parsed into an integer. index: A collection, array or comma-separated list of numbers. (Default: "count") |
| value | false | false | javax.el.ValueExpression
(must evaluate to java.lang.Object)
| The value valid for the type. If this evaluates to null, all children will be rendered. If the type is count, this value must evaluate to a java Number instance or a value which the toString() method can be used with Integer.parseInt(String). The first number of children that are rendered (isRendered() returns true) up to the given value will be rendered. If the type is index, the value must be a Collection, int[], Object[] or a comma-separated list of numbers. Each item in the list must be a valid number. If negative, it is taken from then end. If the child at the given index is not rendered, then that component is skipped (so the indexes are absolute). See the documentation on the myfaces website for more information. |
| id | false | false | java.lang.String | 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. |
| rendered | false | false | javax.el.ValueExpression
(must evaluate to boolean)
| A boolean value that indicates whether this component should be rendered. Default value: true. |
| binding | false | false | javax.el.ValueExpression
(must evaluate to java.lang.Object)
| Identifies a backing bean property (of type UIComponent or appropriate subclass) to bind to this component instance. This value must be an EL expression. |