Adobe Extending Dreamweaver CS4 - 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 " and the tagref.name is
"if" , then the tag is of the form " . 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