Adobe Extending Dreamweaver CS4 - Manual (Page 14)

8 EXTENDING DREAMWEAVER CS4
Customizing Dreamweaver
• start_string specifies a delimiter that marks the beginning of a string-delimited tag. String-delimited tags can
appear anywhere in the document where a comment can appear. Dreamweaver does not parse tags or decode
entities or URLs between
start_string and end_string . This attribute is required if end_string is specified.
• end_string specifies a delimiter that marks the end of a string-delimited tag. This attribute is required if
start_string is specified.
• detect_in_attribute indicates whether to ignore everything between start_string and end_string (or
between opening and closing tags if those strings are not defined) even when those strings appear inside attribute
names or values. You should generally set this to
"true" for string-delimited tags. The default is "false" . For
example, ASP tags sometimes appear inside attribute values, and sometimes contain quotation marks ("). Because
the ASP tag specification specifies
detect_in_attribute="true" , Dreamweaver ignores the ASP tags, including
the internal quotation marks, when they appear inside attribute values.
• parse_attributes indicates whether to parse the attributes of the tag. If this is set to "true" (the default),
Dreamweaver parses the attributes; if it’s set to "false" , Dreamweaver ignores everything until the next closing
angle bracket that appears outside quotation marks. For example, this attribute should be set to "false" for a tag
such as cfif (as in , which Dreamweaver cannot parse as a set of attribute name/value pairs).
• icon specifies the path and filename of the icon associated with the tag. This attribute is required for empty tags,
and for nonempty tags whose contents do not appear in the Document window’s Design view.
• icon_width specifies the width of the icon in pixels.
• icon_height specifies the height of the icon in pixels.
• equivalent_tag specifies simple HTML equivalents for certain ColdFusion form-related tags. This is not
intended for use with other tags.
• is_visual indicates whether the tag has a direct visual effect on the page. For example, the ColdFusion tag
cfgraph doesn’t specify a value for is_visual (so the value defaults to "true" ); the ColdFusion tag cfset is
specified as having is_visual set to "false" . Visibility for server markup tags is controlled by the Invisible
Elements category of the Preferences dialog box; visibility for visual server markup tags can be set independently of
visibility for nonvisual server markup tags.
• server_model , if specified, indicates that the tagspec tag applies only on pages that belong to the specified server
model. If server_model is not specified, the tagspec tag applies on all pages. For example, the delimiters for ASP
and JSP tags are the same, but the tagspec tag for JSP specifies a server_model of "JSP" , so when Dreamweaver
encounters code with the appropriate delimiters on a JSP page, it displays a JSP icon. When it encounters such code
on a non-JSP page, it displays an ASP icon.
Contents
None (empty tag).
Container
None.
Example
"marker_model" icon="happy.gif" icon_width="18" icon_height="18">