Populating Dialog Boxes With Tag Data; Generating A Tag - MACROMEDIA COLDFUSION STUDIO 5-USING COLDFUSION 5 STUDIO Use Manual

Building Tag Editors

Populating dialog boxes with tag data

Once the layout of controls is completed, you need to define the way in which the
editor controls are populated when you are editing an existing tag. This is done in the
attributes
The
attributes
the way in which tag attribute values are inserted into the dialog controls.
<attributes>
<attrib name="value" control="txtName"/>
<attrib name="title" control="txtTitle"/>
<attrib name="title" control="txtTitle2"/>
<attrib name="alt" control="txtAltText"/>
<attrib name="align" control="dropAlign"/>
</attributes>
The
name
control
can have multiple
complex tag editor dialog boxes where a single attribute value may have to be filled
into multiple controls.
Special attrib tag variable names
The following special variables can be used:
$$TAGBODY
be populated by the body of a tag. An example of such a tag editor is the editor for
the HTML tag
txtTextAreaContent
<attrib name="$$TAGBODY" control="txtTextAreaContent"/>
$$TAGSTRING and $$WHOLETAGSTRING
populate controls with the start tag string or the whole tag including its start tag,
body and the end tag. This allows ActiveX controls to be passed to the entire tag
for custom processing and specialized tag editor behavior.
$$EmbeddedCodeString Represents just the text within a tag. It excludes the
tag name, delimiters, and white space outside the text block.

Generating a tag

The final stage in the process of building a tag editor is defining how a tag gets
generated from the date entered in the editor controls. The tag generation logic is
stored in the
the final tag string.
A good way to get started is to have a look at the taglayout sections of existing HTML
tag editors located in the \Extensions\TagDefs\HTML directory.
block of the main tag editor template.
block can contain
attribute of the
attrib
specifies which control the value of that attribute should be assigned to. You
tags with the same name. This is common for more
attrib
This special tag attribute name is used when a control needs to
. The body of the
textarea
control using the following
block. This block contains a short template used to generate
taglayout
and tags. The
attrib event
tag specifies the name of the attribute, while
tag is filled into the
textarea
attrib
These attributes can be used to
177
tag defines
attrib
code: