Adobe Extending Dreamweaver CS4 User Manual
Page 210

204
EXTENDING DREAMWEAVER CS4
Tag libraries and editors
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 namespace, or some other
logical grouping.
The following table lists the
taglibrary
attributes:
The following table lists
tagref
attributes:
Because the
tagref.prefix
attribute can override the
taglibrary.prefix
attribute, the relationship between the
two attributes can be confusing. The following table shows the relationship between the
taglibrary.prefix
and
tagref.prefix
attributes:
Attribute
Description
Mandatory/optional
taglibrary.name
Used to refer to the tag library in the UI.
Mandatory
taglibrary.doctypes
Indicates the document types for which this library is active.
When the library is active, library tags appear in the code hints
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.
Optional
taglibrary.servermodel
If the tags in the tag library execute on an application server, the
servermodel
attribute identifies the server model of the tag. If
the tags are client-side tags (not server-side tags), the
servermodel
attribute is omitted. The
servermodel
attribute
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 Extension Manager
uses the ID attribute, so the MXP files can insert a new
taglibrary
and the
tags
files into the TagLibraries.vtm file.
Optional
taglibrary.tagchooser
A relative path to the TagChooser.xml file that is associated with
this tag library.
Optional
Attribute
Description
Mandatory/optional
tagref.name
Used to refer to the tag in the UI.
Mandatory
tagref.prefix
Specifies how the tag appears in Code view. When used, the
tagref.prefix
attribute determines the prefix of the current
tag. When the attribute is defined, it overrides the value specified
for the
taglibrary.prefix
attribute.
Optional
tagref.file
References the VTML file for the tag.
Optional
Is the taglibrary.prefix defined?
Is the tagref.prefix defined?
Resulting tag prefix
No
No
'<' + tagref.name
Yes
No
taglibrary.prefix + tagref.name
No
Yes
tagref.prefix
Yes
Yes
tagref.prefix