User Guide

36 Chapter 2: Extending Dreamweaver
• content_model describes what kinds of content the tag can contain and where in an HTML
file the tag can appear. Valid values are
"block_model", "head_model", "marker_model",
and
"script_model":
■ block_model specifies that the tag can contain block-level elements such as div and p, and
that the tag can appear only in the body section or inside other body-content tags such as
div, layer, or td.
■ head_model specifies that the tag can contain text content and that it can appear only in the
HEAD section.
■ marker_model specifies that the tag can contain any valid HTML code, and that it can
appear anywhere in an HTML file. The HTML validator in Dreamweaver ignores tags that
are specified as marker_model. However, the validator doesn’t ignore the contents of such a
tag; so even though the tag itself can appear anywhere, the contents of the tag may result in
invalid HTML in certain places. For example, plain text can’t appear (outside of a valid head
element) in the head section of a document, so you can’t place a marker_model tag that
contains plain text in the head section. (To place a custom tag containing plain text in the
head section, specify the tag’s content model as head_model instead of marker_model.) Use
marker_model for tags that should be displayed inline (inside a block-level element such as
p or div—for example, inside a paragraph). If the tag should be displayed as a paragraph of
its own, with line breaks before and after it, don’t use this model.
■ script_model lets the tag exist anywhere between the opening and closing HTML tags of a
document. When Dreamweaver encounters a tag with this model, it ignores all of the tag’s
content. Used for markup (such as certain ColdFusion tags) that Dreamweaver
shouldn’t parse.
• 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 <cfif a is 1>,
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.