composite
Tag interface


This element declares the usage contract for a composite component. Optionally, and at the component author's discretion, this contract exposes the features of one or more inner components to the page author. The page author can work with the composite component as a single component whose feature set is the union of the features declared in the usage contract.

For example, consider a composite component that implements the functionality of a "login panel". Such a component would likely have two text fields and one button. The user of such a component might like to do one or more of the following.

For each of the behaviorial interfaces in Section 3.2 of the specification, there is a tag in the composite: library to nest inside of the <composite:interface> section.

If the <composite:interface> section is not present in a PDL page, the contract will be inferred as described in the specification. There must be zero or one of these elements in a composite component PDL file. If a <composite:interface> element does appear, there must be an accompanying <composite:implementation> element in the same PDL file.



Tag Information
Tag ClassNone
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
namefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)

The name of this composite component. Advisory only. The real name is taken from the filename. The value of this attribute will be set as the value for this property on the composite component bean descriptor.

componentTypefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)

The component-type of the UIComponent that will serve as the composite component root for this composite component. The declared component-family for this component must be javax.faces.NamingContainer.

displayNamefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)

The name to display in a tool palette containing this component. The value of this attribute will be set as the value for this property on the composite component bean descriptor.

preferredfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)

Is this a "preferred" component. The value of this attribute will be set as the value for this property on the composite component bean descriptor.

expertfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)

Is this component only for expert users? The value of this attribute will be set as the value for this property on the composite component bean descriptor.

shortDescriptionfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)

A short description of the purpose of this component. The value of this attribute will be set as the value for this property on the composite component bean descriptor.


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.