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 ClassNone
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

(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.

(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.

(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.

No Variables Defined.

Output Generated by Tag Library Documentation Generator.