How to use the Tag Chooser in Dreamweaver.

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:

 <?xml version="1.0" encoding="iso-8859-1" standalone="yes" ?> 
 <tclibrary name="Friendly name for library node" desc='Description for incorporated 
    reference' reference="Language[,Topic[,Subtopic]]"> 
     <category name="Friendly name for category node" desc='Description for incorporated 
    reference' reference="Language[,Topic[,Subtopic]]" id="Unique id"> 
         <category name="Friendly name for subcategory node" ICON="Relative path" 
        desc='Description for incorporated reference' reference="Language,Topic[,Subtopic]" 
        id="Unique id"> 
             <element name="Friendly name for list item" value='Value to pass to visual dialog 
            editors' desc='Description for incorporated reference' 
            reference="Language[,Topic[,Subtopic]]" id="Unique id"/> 
             ... more elements to display in the list view ... 
         </category> 
         ... more subcategories ... 
     </category> 
     ... more categories ... 
 </tclibrary>

The following table lists the tags that are available for use in the TagChooser.xml files:

Tag

Description

Mandatory/Optional

tclibrary

The tag is the outermost tag, which encapsulates this tag library’s Tag Chooser structure.

Mandatory

tclibrary.name

Value appears in the Tree view node.

Mandatory

tclibrary.desc

Value is an HTML string and appears in the Tag Info section of the Tag Chooser dialog box. If there is no desc attribute, the information for Tag Info comes from the Reference panel. Interchangeable with tclibrary.reference.

Optional (desc and reference are mutually exclusive)

tclibrary.reference

Value describes the language, topic, and subtopic to display in the Tag Info section of the Tag Chooser dialog box. Interchangeable with tclibrary.desc.

Optional (desc and reference are mutually exclusive)

The category tag represents all other nodes in the Tree view under the tclibrary’s node, as shown in the following table:

Tag

Description

Mandatory/Optional

category.name

Value appears in the Tree view node.

Mandatory

category.desc

Value is an HTML string that appears in the Tag Info section of the Tag Chooser dialog box. If neither desc nor reference attr is specified, nothing appears in the Tag info section.

Optional (desc and reference are mutually exclusive)

category.reference

Value describes the language, topic, and subtopic to display in the Tag info section.

Optional (desc and reference are mutually exclusive)

category.icon

Value is a relative path to an icon GIF.

Optional

category.id

Any string that is different from the category.id attributes of other categories in this file.

Mandatory

The following table lists the attributes of the element tag, which represents the tag to insert:

Attribute

Description

Mandatory/Optional

element.name

Value appears as a List view item.

Mandatory

element.value

Value that is either placed directly into the code or a parameter that passes into visual dialog boxes.

Mandatory

element.desc

Value is an HTML string and appears in the incorporated Reference panel. If not specified, the reference attribute displays reference content in the incorporated Reference panel.

Optional (desc and reference are mutually exclusive)

element.reference

As many as three strings separated by commas that describe the language, topic, and subtopic, respectively. This information appears in the Reference panel. The first string is mandatory. The second string is mandatory for the element tag only; optional for category and tclibrary tags. The third string is optional.

Optional (desc and reference are mutually exclusive)

element.id

Any string that is different from the element.id attributes of other elements in this file.

Optional