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.
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>
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 |
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 |