Jakarta Faces 4.1 Facelet Tag Libraries that wish to conform to + this schema must declare it in the following manner.
+ + <facelet-taglib xmlns="https://jakarta.ee/xml/ns/jakartaee" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/web-facelettaglibrary_4_1.xsd" + version="4.1"> + + ... + + </facelet-taglib> + +The instance documents may indicate the published + version of the schema using xsi:schemaLocation attribute + for jakartaee namespace with the following location:
+ +https://jakarta.ee/xml/ns/jakartaee/web-facelettaglibrary_4_1.xsd
+ + ]]> +The attribute element defines an attribute for the nesting + tag. The attribute element may have several subelements + defining:
+ +a description of the attribute +
the name of the attribute +
whether the attribute is required or + optional +
the type of the attribute +
If not present then the default is "false", i.e + the attribute is optional.
+ + ]]> +
+
+ 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 )
As of 3.0 of the specification, this requirement is no longer
+ present: This element must have exactly one of
+ <component-type>, <resource-id>,
+ or <handler-class> among its child elements.
<resource-id>myCC/ccName.xhtml</resource-id>
Defines the canonical name of a tag or attribute being + defined.
+ +The name must conform to the lexical rules for an NCName
+ + + ]]> +All Jakarta Faces configuration files must indicate + the Jakarta Faces schema by indicating the + Jakarta Faces namespace:
+ +https://jakarta.ee/xml/ns/jakartaee
+ +and by indicating the version of the schema by + using the version element as shown below:
+ +<faces-config xmlns="https://jakarta.ee/xml/ns/jakartaee" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="..." + version="4.1"> + ... + </faces-config>+ +
The instance documents may indicate the published + version of the schema using xsi:schemaLocation attribute + for jakartaee namespace with the following location:
+ +https://jakarta.ee/xml/ns/jakartaee/web-facesconfig_4_1.xsd
+ + ]]> +This value is taken to be the + defining document id of any <flow-definition> elements + defined in this Application Configuration Resource file. If this + element is not specified, the runtime must take the empty string + as its value.
+ + ]]> +Attribute names must be unique within the scope of the parent + (or related) component.
+ + ]]> +Nested "attribute" elements identify generic attributes that + are recognized by the implementation logic of this component. + Nested "property" elements identify JavaBeans properties of + the component class that may be exposed for manipulation + via tools.
+ + ]]> ++ To facilitate BCP 47 this element first needs to be parsed by the + Locale.forLanguageTag method. If it does not return a Locale with + a language the old specification below needs to take effect. +
+ +It must be specified as :language:[_:country:[_:variant:]] + without the colons, for example "ja_JP_SJIS". The + separators between the segments may be '-' or '_'.
+ + ]]> +The exact match for a view identifier that is recognized + by the the ViewHandler implementation being used (such as + "/index.jsp" if you are using the default ViewHandler).
The exact match of a flow node id + in the current flow, or a flow id of another flow.
A proper prefix of a view identifier, plus a trailing + "*" character. This pattern indicates that all view + identifiers that match the portion of the pattern up to the + asterisk will match the surrounding rule. When more than one + match exists, the match with the longest pattern is selected. +
An "*" character, which means that this pattern applies + to all view identifiers.
When used in a <switch> within a flow, if the
+ expresion returns true, the
+ <from-outcome> sibling element's outcome is used as
+ the id of the node in the flow graph to which control must be
+ passed.
Nested "attribute" elements identify generic attributes that + may be configured on the corresponding UIComponent in order + to affect the operation of the Converter. Nested "property" + elements identify JavaBeans properties of the Converter + implementation class that may be configured to affect the + operation of the Converter. "attribute" and "property" + elements are intended to allow component developers to + more completely describe their components to tools and users. + These elements have no required runtime semantics.
+ + ]]> +If there is no <start-node> element declared, it
+ is assumed to be <flowName>.xhtml.
FlowHandler.
+
+ ]]>
+ + + ]]> +
+ + ]]> +
+ + ]]> +
+ + ]]> +
This element must contain exactly one
+ <vdl-document> element.
+ + ]]> +
This element must contain one or more
+ <case> elements. When control passes to the
+ <switch> node, each of the cases must be considered
+ in order and control must past to the <from-outcome>
+ of the first one whose <if> expression evaluates to
+ true.
<switch>.
+
+ ]]>
+ <switch> are taken.
+
+ ]]>
+ <switch>.
+
+ ]]>
+ true, the corresponding from-outcome will
+ be the outcome taken by the enclosing <switch>
+
+ ]]>
+ If used in a faces flow, this element + represents the node id to which control will be passed.
+ + ]]> +This element must contain exactly one <from-outcome> element.
This element must contain exactly one <flow-reference> element,
+ which must contain exactly one <flow-id> element.
+ + ]]> +
+ + ]]> +
MethodExpression that will be invoked when the flow is entered.+ + ]]> +
MethodExpression that will be invoked when the flow is exited.+ + ]]> +
+ + ]]> +
+ + ]]> +
The "null-value" element can only be used when the + associated "property-class" identifies a Java class, + not a Java primitive.
+ + ]]> +Property names must be unique within the scope of the Java + class that is represented by the parent element, and must + correspond to property names that will be recognized when + performing introspection against that class via + java.beans.Introspector.
+ + ]]> +Nested "attribute" elements identify generic component + attributes that are recognized by this renderer.
+ + ]]> +Nested "attribute" elements identify generic component + attributes that are recognized by this renderer.
+ + ]]> ++ To facilitate BCP 47 this element first needs to be parsed by the + Locale.forLanguageTag method. If it does not return a Locale with + a language the old specification below needs to take effect. +
+ +It must be specified as :language:[_:country:[_:variant:]] + without the colons, for example "ja_JP_SJIS". The + separators between the segments may be '-' or '_'.
+ + ]]> +Nested "attribute" elements identify generic attributes that + may be configured on the corresponding UIComponent in order + to affect the operation of the Behavior. Nested "property" + elements identify JavaBeans properties of the Behavior + implementation class that may be configured to affect the + operation of the Behavior. "attribute" and "property" + elements are intended to allow component developers to + more completely describe their components to tools and users. + These elements have no required runtime semantics.
+ + ]]> +Nested "attribute" elements identify generic attributes that + may be configured on the corresponding UIComponent in order + to affect the operation of the Validator. Nested "property" + elements identify JavaBeans properties of the Validator + implementation class that may be configured to affect the + operation of the Validator. "attribute" and "property" + elements are intended to allow component developers to + more completely describe their components to tools and users. + These elements have no required runtime semantics.
+ + ]]> +This element must have an "id" attribute whose value + is the return from calling getContainerClientId() on the + UIViewRoot to which this response pertains. + +
+ + ]]> ++ +
+ + ]]> ++ + ]]> +