web-jsptaglibrary_1_1.dtd: Elements - Entities - Source | Intro - Index
FRAMES / NO FRAMES
This is the DTD defining the JavaServer Pages 1.1 Tag Library descriptor (.tld) (XML) file format/syntax.
A Tag Library is a JAR file containing a valid instance of a Tag Library Descriptor (taglib.tld) file in the META-INF subdirectory, along with the appropriate implementing classes, and other resources required to implement the tags defined therein.
Use is subject to license terms.
| <taglib> | Root element |
The taglib tag is the document root, it defines:
tlibversion the version of the tag library implementation jspversion the version of JSP the tag library depends upon
shortname a simple default short name that could be used by a JSP authoring tool to create names with a mnemonic value; for example, the it may be used as the prefered prefix value in taglib directives uri a uri uniquely identifying this taglib info a simple string describing the "use" of this taglib, should be user discernable
Element's model:
<taglib>'s children Name Cardinality info One or none jspversion One or none shortname Only one tag At least one tlibversion Only one uri One or none
<taglib>'s attributes Name Values Default id Match the ID rules. xmlns http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd
(tlibversion, jspversion?, shortname, uri?, info?, tag+)
| @id | Attribute of taglib |
Element identifier.
Possible values: Match the ID rules.
| @xmlns | Attribute of taglib |
XML namespace of the element.
Fixed value: http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd
| <tlibversion> | Child of taglib |
Describes this version (number) of the taglibrary (dewey decimal)
#PCDATA ::= [0-9]*{ "."[0-9] }0..3
<tlibversion>'s attributes Name Values Default id Match the ID rules.
| <jspversion> | Child of taglib |
Describes the JSP version (number) this taglibrary requires in order to function (dewey decimal)
The default is 1.1
#PCDATA ::= [0-9]*{ "."[0-9] }0..3
<jspversion>'s attributes Name Values Default id Match the ID rules.
| <shortname> | Child of taglib |
Defines a short (default) shortname to be used for tags and variable names used/created by this tag library. Do not use white space, and do not start with digits or underscore.
#PCDATA ::= NMTOKEN
<shortname>'s attributes Name Values Default id Match the ID rules.
| <uri> | Child of taglib |
Defines a public URI that uniquely identifies this version of the taglibrary Leave it empty if it does not apply.
<uri>'s attributes Name Values Default id Match the ID rules.
| <info> | Child of tag, taglib |
Defines an arbitrary text string descirbing the tag library
<info>'s attributes Name Values Default id Match the ID rules.
| <tag> | Child of taglib |
The tag defines a unique tag in this tag library, defining:
- the unique tag/element name - the subclass of javax.servlet.jsp.tagext.Tag implementation class - an optional subclass of javax.servlet.jsp.tagext.TagExtraInfo - the body content type (hint) - optional tag-specific information - any attributes
Element's model:
<tag>'s children Name Cardinality attribute Any number bodycontent One or none info One or none name Only one tagclass Only one teiclass One or none
<tag>'s attributes Name Values Default id Match the ID rules.
(name, tagclass, teiclass?, bodycontent?, info?, attribute*)
| <tagclass> | Child of tag |
Defines the subclass of javax.serlvet.jsp.tagext.Tag that implements the request time semantics for this tag. (required)
#PCDATA ::= fully qualified Java class name
<tagclass>'s attributes Name Values Default id Match the ID rules.
| <teiclass> | Child of tag |
Defines the subclass of javax.servlet.jsp.tagext.TagExtraInfo for this tag. (optional)
If this is not given, the class is not consulted at translation time.
#PCDATA ::= fully qualified Java class name
<teiclass>'s attributes Name Values Default id Match the ID rules.
| <bodycontent> | Child of tag |
Provides a hint as to the content of the body of this tag. Primarily intended for use by page composition tools.
There are currently three values specified:
tagdependent The body of the tag is interpreted by the tag implementation itself, and is most likely in a different "langage", e.g embedded SQL statements.
JSP The body of the tag contains nested JSP syntax
empty The body must be empty
The default (if not defined) is JSP
#PCDATA ::= tagdependent | JSP | empty
<bodycontent>'s attributes Name Values Default id Match the ID rules.
| <attribute> | Child of tag |
The attribute tag defines an attribute for the nesting tag
An attribute definition is composed of:
- the attributes name (required) - if the attribute is required or optional (optional) - if the attributes value may be dynamically calculated at runtime by a scriptlet expression (optional)
Element's model:
<attribute>'s children Name Cardinality name Only one required One or none rtexprvalue One or none
<attribute>'s attributes Name Values Default id Match the ID rules.
(name, required?, rtexprvalue?)
| <name> | Child of attribute, tag |
Defines the canonical name of a tag or attribute being defined
#PCDATA ::= NMTOKEN
<name>'s attributes Name Values Default id Match the ID rules.
| <required> | Child of attribute |
Defines if the nesting attribute is required or optional.
#PCDATA ::= true | false | yes | no
If not present then the default is "false", i.e the attribute is optional.
<required>'s attributes Name Values Default id Match the ID rules.
| <rtexprvalue> | Child of attribute |
Defines if the nesting attribute can have scriptlet expressions as a value, i.e the value of the attribute may be dynamically calculated at request time, as opposed to a static value determined at translation time.
#PCDATA ::= true | false | yes | no
If not present then the default is "false", i.e the attribute has a static value
<rtexprvalue>'s attributes Name Values Default id Match the ID rules.
| @id | Attribute of tlibversion |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of jspversion |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of shortname |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of uri |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of info |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of tag |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of tagclass |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of teiclass |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of bodycontent |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of attribute |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of name |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of required |
Element identifier.
Possible values: Match the ID rules.
| @id | Attribute of rtexprvalue |
Element identifier.
Possible values: Match the ID rules.