Adobe 38040334 - Dreamweaver CS3 User Manual page 15

The following information describes the attributes and valid values for the
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.
{}
<tagspec>
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}
• is the name of the custom tag. For string-delimited tags,
tag_name
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, the inspector can be used for tags of this type. For example, the tag name for ASP
code is Property inspectors that can examine ASP code should have
ASP.
on the Property inspector API, see "Property inspectors" on page 210.
•
determines whether the tag is empty (as the
tag_type
opening and closing tags (as the
It's ignored for string-delimited tags because they're always empty. Valid values are
•
determines whether the contents of the tag should appear in the Design view or whether the
render_contents
specified icon should appear instead. This attribute is required for nonempty tags and is ignored for empty tags.
(Empty tags have no content.) This attribute applies only to tags that appear outside attributes. The contents of
tags that appear inside the values of attributes of other tags are not rendered. Valid values are
• describes what kinds of content the tag can contain and where in an HTML file the tag can
content_model
appear. Valid values are
•
specifies that the tag can contain block-level elements such as
block_model
appear only in the body section or inside other body-content tags such as
• specifies that the tag can contain text content and that it can appear only in the head section.
head_model
•
specifies that the tag can contain any valid HTML code, and that it can appear anywhere in an
marker_model
HTML file. The HTML validator in Dreamweaver ignores tags that are specified as
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 cannot appear (outside
a valid head element) in the head section of a document, so you can't place a
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
inline (inside a block-level element such as
displayed as a paragraph of its own, with line breaks before and after it, don't use this model.
•
lets the tag exist anywhere between the opening and closing HTML tags of a document. When
script_model
Dreamweaver encounters a tag with this model, it ignores all of the tag's content. Use this tag for markup (such
as certain ColdFusion tags) that Dreamweaver shouldn't parse.
•
specifies a delimiter that marks the beginning of a string-delimited tag. String delimited tags can
start_string
appear anywhere in the document where a comment can appear. Dreamweaver does not parse tags or decode
entities or URLs between
tag does). This attribute is required for normal (nonstring-delimited) tags.
code
,
"block_model" "head_model"
instead of
marker_model
or
p
and
start_string end_string
tagspec
tag_name
*ASP*
tag is), or whether it contains anything between its
img
, , and
"marker_model"
.) Use
marker_model
—for example, inside a paragraph). If the tag should be
div
. This attribute is required if
DREAMWEAVER CS3
Extending Dreamweaver
tag. Attributes marked with an
is used only to determine whether
on the first line. For information
and
"empty" "nonempty"
and
"true"
.
"script_model"
and , and that the tag can
div p
, , or .
div layer td
. However,
marker_model
tag that contains
marker_model
for tags that should be displayed
is specified.
end_string
9
.
.
"false"