background image

Top-Level Tag Library Descriptor Elements

<< Tag Library Descriptors | Declaring Tag Files >>
<< Tag Library Descriptors | Declaring Tag Files >>

Top-Level Tag Library Descriptor Elements

TABLE 8­6
taglib
Subelements
(Continued)
Element
Description
display-name
(optional) Name intended to be displayed by tools.
icon
(optional) Icon that can be used by tools.
tlib-version
The tag library's version.
short-name
(optional) Name that could be used by a JSP page-authoring tool to create names with a
mnemonic value.
uri
A URI that uniquely identifies the tag library.
validator
See
"validator Element" on page 248
.
listener
See
"listener Element" on page 249
.
tag-file | tag
Declares the tag files or tags defined in the tag library. See
"Declaring Tag Files" on page 249
and
"Declaring Tag Handlers" on page 251
. A tag library is considered invalid if a tag-file
element has a name subelement with the same content as a name subelement in a tag
element.
function
Zero or more EL functions (see
"Functions" on page 165
) defined in the tag library.
tag-extension
(optional) Extensions that provide extra information about the tag library for tools.
Top-Level Tag Library Descriptor Elements
This section describes some top-level TLD elements. Subsequent sections describe how to
declare tags defined in tag files, how to declare tags defined in tag handlers, and how to declare
tag attributes and variables.
validator
Element
This element defines an optional tag library validator that can be used to validate the
conformance of any JSP page importing this tag library to its requirements.
Table 8­7
lists the
subelements of the validator element.
TABLE 8­7
validator
Subelements
Element
Description
validator-class
The class implementing javax.servlet.jsp.tagext.TagLibraryValidator
init-param
(optional) Initialization parameters
Tag Library Descriptors
The Java EE 5 Tutorial · September 2007
248