Specifications

Tag Libraries and Editors 113
The ELEMENT tag represents the tag to insert, with attributes as described in the following table:
Creating a new tag editor
The examples in this section use CFWEATHER, a hypothetical ColdFusion tag that was written to
extract the current temperature from a weather database, to illustrate the steps necessary to create
a new tag editor.
The attributes for
CFWEATHER are as described in the following table:
Registering the tag in the tag library
For Dreamweaver to recognize the new tag, it must be identified in the TagLibraries.vtm file,
which is located in the Configuration/TagLibraries folder. However, if the user is on a system
that supports multiple users (such as Windows XP, Windows 2000, or Mac OS X), the user has
another TagLibraries.vtm file in their Configuration folder. This file is the one that needs to be
updated because this file is the instance that Dreamweaver looks for and parses.
The location of the user’s Configuration folder depends on the user’s platform.
For Windows 2000 and Windows XP platforms:
<drive>:\Documents and Settings\<username>\ ¬
Application Data\Macromedia\Dreamweaver MX\Configuration
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 editors.
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 describes 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
Attribute Description
zip A five-digit ZIP code
tempaturescale The temperature scale (Celsius or Farhenheit)
Tag Description Mandatory/
Optional