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>
  4.  
  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 PDL page is:

  1. <composite:interface>
  2.   <composite:valueHolder targets="userid,password" />
  3. </composite:interface>
  4.  
  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

Attributes
NameRequiredRequest-timeTypeDescription
nametruefalsejavax.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.

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


Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.