Adobe 38040334 Extending Dreamweaver - Page 209

DREAMWEAVER CS3 203 Extending Dreamweaver Tag category.reference category.icon category.id Description Mandatory/Optional Value describes the language, topic, and subtopic to display in the Tag Optional (desc and info section. reference are mutually exclusive) Value is a relative path to an icon GIF. Optional 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 element.name element.value element.desc element.reference element.id Description Mandatory/Optional Value appears as a List view item. Mandatory Value that is either placed directly into the code or a parameter that passes into visual dialog boxes. Mandatory 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) 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) Any string that is different from the element.id attributes of other Optional elements in this file. A simple example of creating a new tag editor The examples in this section use cfweather, a hypothetical ColdFusion tag designed to extract the current temperature from a weather database, to illustrate the steps necessary to create a new tag editor. The attributes for the cfweather tag are described in the following table: Attribute zip tempaturescale Description A five-digit ZIP code The temperature scale (Celsius or Farhenheit) You create this new tag editor by performing the following steps: • "Registering the tag in the tag library" on page 204 • "Creating a tag definition (VTML) file" on page 204 • "Creating a tag editor UI" on page 205 • "Adding a tag to Tag Chooser" on page 207