Overview | Library | Tag | Help
| FRAMES NO FRAMES

## composite
Tag valueHolder

Declares that the composite component whose contract is declared by the `<composite:interface>` in which this element is nested exposes an implementation of `ValueHolder` suitable for use as the target of attached objects in the using page. Any attached objects suitable for implementations of `ValueHolder` may be attached to the composite component. Consider this excerpt from the using page:

1. <ez:foo>
2. <f:converter for="userid" binding="#{bean.converter}" />
3. </ez:foo>

Line 2 refers to the `<composite:valueHolder>` declaration on line 2 of `foo.xhtml`:

1. <composite:interface>
2. <composite:valueHolder name="userid" />
3. </composite:interface>
5. <composite:implementation>
6. <h:inputText id="userid" />
7. </composite:implementation>

It is possible to declare that a single `<composite:valueHolder>` element should cause multiple components within the `<composite:implementation>` section to be the targets of an attached object in the using page. Assuming the same using page excerpt as above, the revised VDL view is:

1. <composite:interface>
2. <composite:valueHolder targets="userid,password" />
3. </composite:interface>
5. <composite:implementation>
6. <h:inputText id="userid" />
7. <h:inputText id="password" />
8. </composite:implementation>

In this case, the "targets" attribute on the `<composite:valueHolder>` element, on line 2 above, replaces the "name" attribute in the previous example. "targets" is a list of ids of client ids (relative to the top level component) within the `<composite:implementation>` section. In this case, "targets" refers to the `<h:inputText>` components on lines 6 and 7 above.

Please see `<composite:interface>` for a usage example.

Tag Information
Tag Class | None
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
name | true | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | The value of this attribute maps back to the "for" attribute on an attachable object nested within a composite component. If the "targets" attribute is not specified, this value also represents the component ID of the target component within the that the `<composite:implementation>` ActionListener should be mapped to.
targets | false | false | `javax.el.ValueExpression` (must evaluate to `java.lang.String`) | If present, this must be a space (not tab) separated list of client ids (relative to the top level component) of components within the `<composite:implementation>` section. Space is used as the delimiter for compatibility with the IDREFS and NMTOKENS data types from the XML Schema.
hidden | false | false | `javax.el.ValueExpression` (must evaluate to `boolean`) | The "hidden" flag is used to identify features that are intended only for tool use, and which should not be exposed to humans.

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator.