The tag chooser, Tagchooser.xml files – Adobe Extending Dreamweaver CS4 User Manual

Page 212

206

EXTENDING DREAMWEAVER CS4

Tag libraries and editors

Note: In versions before Dreamweaver MX, tag information is stored in the Configuration/TagAttributeList.txt file.

The Tag Chooser

The Tag Chooser lets you view tags in functional groups so you can easily access frequently used tags. In order to add
a tag or a set of tags to the Tag Chooser, you must add it to the tag library. You can do this by using the Tag Library
Editor dialog box or by installing a Dreamweaver extension, which is packaged in an MXP file

TagChooser.xml files

The TagChooser.xml files provide the metadata for organizing tag groupings that appear in the Tag Chooser. Each tag
that comes with Dreamweaver is stored in a functional grouping and is available in the Tag Chooser. By editing the
TagChooser.xml files, you can regroup existing tags and group new tags. You can customize how tags are organized
for your users by creating subcategories so they can easily access their most important tags.

The TagLibraries.vtm files support the use of the

taglibrary.tagchooser

attribute, which points to the

TagChooser.xml files. If you change existing TagChooser.xml files or create new ones, the

taglibrary.tagchooser

attribute must point to the correct location for the Tag Chooser to be fully functional.

If there is no

taglibrary.tagchooser

attribute, the Tag Chooser displays the tree structure that is in the

TagLibraries.vtm file.

TagChooser.xml files are stored in the Configuration/TagLibraries/TagLibraryName folder. The following example
shows the structure of TagChooser.xml files:

tagformat.nlbeforecontents

The number of newline characters to insert
before the contents of this tag.

Optional

tagformat.nlaftercontents

The number of newline characters to insert after
the contents of this tag.

Optional

tagformat.nlaftertag

Specifies whether to insert a newline character
after this tag. The value

indicates no, and the

value

indicates yes.

Optional

attrib.name

The name of the attribute, as it appears in the
source code.

Mandatory

attrib.type

If omitted,

attrib.type

"text"

. It can have

the following values:

TEXT

—free text content

ENUMERATED

—a list of enumerated values

COLOR

—a color value (name or hexadecimal)

FONT

—font name or font family

STYLE

—CSS

styles attribute

CSSSTYLE

—CSS class name

CSSID

—CSS class ID

FILEPATH

—a full file path