.jsf-api.2.2.8-27.source-code.web-facelettaglibrary_2_2.xsd Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jsf-api Show documentation

This is the master POM file for Oracle's Implementation of the JSF 2.2 Specification.

There is a newer version: 2.2.20



  

  
    

      DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
      
      Copyright (c) 2011-2013 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.dev.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.2).
      
      JSF 2.2 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_2.xsd"
      version="2.2">
      
      ...
      
      </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_2.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.



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
        
      
]]>