User Guide

Customizing Dreamweaver 35

You can define two kinds of tags using tagspec: normal HTML-style tags and string-delimited

tags. String-delimited tags start with one string and end with another string; they’re like empty

HTML tags (such as

img) in that they don’t surround content and don’t have closing tags. The

happy tag example is a normal HTML-style tag; it starts with an opening <happy> tag, contains

data between opening and closing tags, and ends with a closing

</happy> tag. (If the tag were a

string-delimited tag, the tag specification would include the

start_string and end_string

attributes.) An ASP tag is a string-delimited tag; it starts with the string <% and ends with the

string

%>, and it has no closing tag.

The following information describes the attributes and valid values for the

tagspec tag.

Attributes marked with an asterisk (*) are ignored for string-delimited tags. Optional attributes

are marked in the attribute lists with curly braces (

{}); all attributes not marked with curly braces

are required.

Description

Provides information about a third-party tag.

Attributes

tag_name

, {tag_type}, {render_contents}, {content_model}, {start_string},

{end_string}, {detect_in_attribute}, {parse_attributes}, icon, icon_width,

icon_height, {equivalent_tag}, {is_visual}, {server_model}

• tag_name is the name of the custom tag. For string-delimited tags, tag_name is used only to

determine whether a given Property inspector can be used for the tag. If the first line of the

Property inspector contains this tag name with an asterisk on each side, then the inspector can

be used for tags of this type. For example, the tag name for ASP code is

ASP; Property

inspectors that can examine ASP code should have

*ASP* on the first line. For information on

the Property inspector API, see Chapter 12, “Property Inspectors,” on page 217.

• tag_type determines whether the tag is empty (as with img), or whether it contains anything

between its opening and closing tags (as with

code). This attribute is required for normal

(nonstring-delimited) tags. It’s ignored for string-delimited tags because they’re always empty.

Valid values are

"empty" and "nonempty".

• render_contents determines whether the contents of the tag should appear in the Document

window’s Design view or whether the specified icon appears instead. This attribute is required

for nonempty tags and ignored for empty tags. (Empty tags have no content.) This attribute

applies only to tags that appear outside of attributes; the contents of tags that appear inside the

values of attributes of other tags are not rendered. Valid values are

"true" or "false".