com.sun.faces.web-facelettaglibrary_3_0.xsd Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of jakarta.faces Show documentation

EE4J Compatible Implementation for Jakarta Faces API

There is a newer version: 4.1.1



  

  
    

      Copyright (c) 2009, 2020 Oracle and/or its affiliates. All rights reserved.
      
      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 Server Faces
      Standard Facelets View Declaration Language (Facelets VDL)
      (Version 3.0).
      
      Jakarta Server Faces 3.0 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_3_0.xsd"
      version="3.0">
      
      ...
      
      </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_3_0.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 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 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

]]>