Specifications

Chapter 10108
The following example illustrates the structure of the TagLibraries.vtm file:
<taglibraries>
<taglibrary name="Name of tag library" doctypes="HTML,ASP-JS,ASP-VB"
tagchooser="relative path to TagChooser.xml file" id="DWTagLibrary_html">
<tagref name="tag name" file="relative path to tag .vtm file"/>
</taglibrary>
<taglibrary name="CFML Tags" doctypes="ColdFusion" servermodel="Cold Fusion"
tagchooser="cfml/TagChooser.xml" id="DWTagLibrary_cfml">
<tagref name="cfabort" file="cfml/cfabort.vtm"/>
</taglibrary>
<taglibrary name="ASP.NET Tags" doctypes="ASP.NET_CSharp,ASP.NET_VB"¬
servermodel="ASPNet" prefix="<asp:" tagchooser="ASPNet/TagChooser.xml"¬
id="DWTagLibrary_aspnet">
<tagref name="dataset" file="aspnet/dataset.vtm" prefix="<mm:dataset"/>
</taglibrary>
</taglibraries>
The taglibrary tag groups one or more tags into a Tag Library. When you import tags or create
a new set of tags, you can group them into Tag Libraries. Typically, a
taglibrary grouping
corresponds to a set of tags that are defined in a JavaServer Pages (JSP) TLD file, an XML
document type definition (DTD) file, an ASP.Net name space, or some other logical grouping.
The following table lists
taglibrary attributes:
Attribute Description Mandatory/
optional
taglibary.name Used to refer to the Tag Library in the
user interface.
Mandatory
taglibrary.doctypes Indicates the document types for which this
library is active. When active, library tags appear
in the Code Hints pop-up menu. Not all Tag
Libraries can be active at the same time because
name conflicts can occur (for example, HTML
and WML files are incompatible).
Mandatory
taglibrary.prefix When specified, tags within the Tag Library have
the form taglibrary.prefix + tagref.name
For example, if the taglibrary.prefix is
"<jrun:" and the tagref.name is "
if" then
the tag is of the form "
<jrun:if".
This can be overridden for a particular tag. See
the information on “taglibrary.prefix” on
page 108 below.
Optional
taglibrary.servermodel If the tags in the Tag Library execute on an
application server,
servermodel identifies the
server model of the tag. If the tags are client-side
tags (not server-side tags), the servermodel
attribute is omitted. servermodel is also used for
Check Target Browsers.
Optional
taglibrary.id This can be any string that is different from the
taglibrary.ID attributes of other Tag
Libraries in the file. The ID attribute is used by the
Extension Manager, so the MXP files can insert
new <taglibrary> and the tags files into the
TagLibraries.vtm file.
Optional
taglibrary.tagchooser A relative file path to the TagChooser.xml file that
is associated with this Tag Library.
Optional