composite
Tag attribute




Attributes
NameRequiredRequest-timeTypeDescription
nametruetruejava.lang.String

The name of the attribute as it must appear on the composite component tag in the using page. If the value of the name attribute is equal to (without the quotes) "action", "actionListener", "validator", or "valueChangeListener", the action described in ViewHandler.retargetMethodExpressions() must be taken to handle the attribute. In these cases, the method-sigature attribute, if present, must be ignored as its value is derived as described in retargetMethodExpressions().

targetsfalsetruejava.lang.Object

If this element has a method-signature attribute, the value of the targets attribute must be interpreted as 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. Each entry in the list must be interpreted as the id of an inner component to which the MethodExpression from the composite component tag in the using page must be applied. If this element has a method-signature attribute, but no targets attribute, the value of the name attribute is used as the single entry in the list. If the value of the name attribute is not one of the special values listed in the description of the name attribute, targets (or its derived value) need not correspond to the id of an inner component.

defaultfalsetruejava.lang.String

If this attribute is not required, and a value is not supplied by the page author, use this as the default value.

requiredfalsetrueboolean

True if the page author must supply a value for this attribute.

method-signaturefalsetruejava.lang.StringDeclares that this attribute must be a MethodExpression whose method signature is described by the value of this attribute. The signature must be described using fully qualified class names wherever a type is required. This attribute is mutually exclusive with the "type" attribute. If both attributes are present, the "method-signature" attribute is ignored. PENDING: when this file is generated from the web-facesuicomponent_2_0.xsd, we will not need to copy the content here manually. Provides the signature of the Java method. The syntax of the method-signature element is as follows (taken from function-signature in web-jsptaglibrary_2_1.xsd): MethodSignature ::= ReturnType S MethodName S? '(' S? Parameters? S? ')' ReturnType ::= Type MethodName ::= Identifier Parameters ::= Parameter | ( Parameter S? ',' S? Parameters ) Parameter ::= Type Where: Type is a basic type or a fully qualified Java class name (including package name), as per the 'Type' production in the Java Language Specification, Second Edition, Chapter 18. Identifier is a Java identifier, as per the 'Identifier' production in the Java Language Specification, Second Edition, Chapter 18. Example: java.lang.String nickName(java.lang.String, int)
typefalsetruejava.lang.String

Declares that this attribute must be a ValueExpression whose expected type is given by the value of this attribute. If not specified, and no "method-signature" attribute is present, java.lang.Object is assumed. This attribute is mutually exclusive with the "type" attribute. If both attributes are present, the "method-signature" attribute is ignored.

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

preferredfalsetrueboolean

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.

expertfalsetrueboolean

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.

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



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.