DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER. Copyright (c) 2011-2015 Oracle and/or its affiliates. All rights reserved. The contents of this file are subject to the terms of either the GNU General Public License Version 2 only ("GPL") or the Common Development and Distribution License("CDDL") (collectively, the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the License at https://glassfish.java.net/public/CDDL+GPL_1_1.html or packager/legal/LICENSE.txt. See the License for the specific language governing permissions and limitations under the License. When distributing the software, include this License Header Notice in each file and include the License file at packager/legal/LICENSE.txt. GPL Classpath Exception: Oracle designates this particular file as subject to the "Classpath" exception as provided by Oracle in the GPL Version 2 section of the License file that accompanied this code. Modifications: If applicable, add the following below the License Header, with the fields enclosed by brackets [] replaced by your own identifying information: "Portions Copyright [year] [name of copyright owner]" Contributor(s): If you wish your version of this file to be governed by only the CDDL or only the GPL Version 2, indicate your decision by adding "[Contributor] elects to include this software in this distribution under the [CDDL or GPL Version 2] license." If you don't indicate a single choice of license, a recipient has the option to distribute your version of this file under either the CDDL, the GPL Version 2 or to extend the choice of license to its licensees as provided above. However, if you add GPL Version 2 code and therefore, elected the GPL Version 2 license, then the option applies only if the new code is made subject to such option by the copyright holder. The XML Schema for the Tag Libraries in the JavaServer Faces Standard Facelets View Declaration Language (Facelets VDL) (Version 2.3).

JSF 2.3 Facelet Tag Libraries that wish to conform to this schema must declare it in the following manner.

<facelet-taglib xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-facelettaglibary_2_3.xsd" version="2.3"> ... </facelet-taglib>

The instance documents may indicate the published version of the schema using xsi:schemaLocation attribute for javaee namespace with the following location:

http://xmlns.jcp.org/xml/ns/javaee/web-facelettaglibary_2_3.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 JSF Behavior.

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

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

As of 2.3 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 spec prose document section 2.6.1.3. 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 JSF Converter.

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

]]> Within a tag element, the validator element encapsulates information specific to a JSF 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

]]>