
22 Customizing Dreamweaver
■ String-delimited tags
String-delimited tags start with one string and end with another string. They are like
empty HTML tags (such as
img) in that they don’t surround content and don’t have
closing tags. If the
happy 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.
<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}
■ 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, 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 279
.
■ tag_type determines whether the tag is empty (as the img tag is), or whether it contains
anything between its opening and closing tags (as the
code tag does). 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
Design view or whether the 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
"true" and "false".
Comentários a estes Manuais