Copyright (c) 2024 Contributors to Eclipse Foundation. This program and the accompanying materials are made available under the terms of the Eclipse Public License v. 2.0, which is available at http://www.eclipse.org/legal/epl-2.0. This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License v. 2.0 are satisfied: GNU General Public License, version 2 with the GNU Classpath Exception, which is available at https://www.gnu.org/software/classpath/license.html. SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 The XML Schema for the Tag Libraries in the Jakarta Faces Standard Facelets View Declaration Language (Facelets VDL) (Version 4.1).

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

]]> tag-names must be unique within a document.

]]> Behavior IDs must be unique within a document.

]]> Converter IDs must be unique within a document.

]]> Validator IDs must be unique within a document.

]]> The top level XML element in a facelet tag library XML file.

]]> An advisory short name for usages of tags from this tag library.

]]> Extension element for facelet-taglib. It may contain implementation specific content.

]]> If the tag library XML file contains individual tag declarations rather than pointing to a library-class or a declaring a composite-library name, the individual tags are enclosed in tag elements.

]]>

The attribute element defines an attribute for the nesting tag. The attribute element may have several subelements defining:

description: a description of the attribute
name: the name of the attribute
required: whether the attribute is required or optional
type: the type of the attribute

]]> Defines if the nesting attribute is required or optional.

If not present then the default is "false", i.e the attribute is optional.

]]> Defines the Java type of the attributes value. If this element is omitted, the expected type is assumed to be "java.lang.Object".

]]> Defines the method signature for a MethodExpression- enabled attribute. The syntax of the method-signature element is as follows (taken from the function-signature EBNF 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 )

]]> Extension element for tag It may contain implementation specific content.

]]> If the tag library XML file contains individual function declarations rather than pointing to a library-class or a declaring a composite-library name, the individual functions are enclosed in function elements.

]]> Within a tag element, the behavior element encapsulates information specific to a Faces Behavior.

]]> Extension element for behavior. It may contain implementation specific content.

]]> Within a tag element, the component element encapsulates information specific to a Faces UIComponent.

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.

]]> A valid resource identifier as specified in the Jakarta Faces Specification Document section 2.6.1.3 "Resource Identifiers". For example:

<resource-id>myCC/ccName.xhtml</resource-id>

]]> Extension element for component It may contain implementation specific content.

]]> Within a tag element, the converter element encapsulates information specific to a Faces Converter.

]]> Extension element for converter It may contain implementation specific content.

]]> Within a tag element, the validator element encapsulates information specific to a Faces Validator.

]]> Extension element for validator It may contain implementation specific content.

]]> This type contains the recognized versions of facelet-taglib supported.

]]>

Defines the canonical name of a tag or attribute being defined.

The name must conform to the lexical rules for an NCName

]]>