User Guide

168 Chapter 2: ColdFusion Tags
Note: Attributes that are marked as Flash only are not handled by the skins provided with ColdFusion
MX. They are, however, included in the generated XML in all controls except text and html types.
Attribute Req/Opt;
Formats
Default Description
type Required;
Flash and
XML
Flash:
• html: place the text in the body of this tag on the form.
For Flash forms, you can use the following text
formatting tags, most of which correspond to HTML
tags, in the text:
a, b, br, font, i, img, li, p, textformat,
and
u. For details on using these formatting tags, see
the Flash documentation. The
style attribute has no
effect on the format of the text in type.
• text: place the text in the body of this tag on the form
verbatim, without interpreting any markup. You can
control the overall appearance of the text by using the
style attribute.
• spacer: places an invisible spacer of the specified
height and width on the form. Used to place space
between form controls. This tag must not have any
children.
• hrule: places a horizontal rule on the form. This tag must
not have any children.
• vrule: places a vertical rule on the form. This tag must
not have any children.
XML:
• html: puts the CFML tag’s body text in a CDATA
section in an XML
xf:output element.
• text: XML-formats (escapes characters such as <) the
CFML tag’s body text and puts it in a CDATA section in
an XML
xf:output element.
• hrule: puts an
hr tag in the output. Use the style
attribute to specify all rule characteristics, including
height and width. This tag must not have any children.
• Any other string: generates an XML
xf:group element
with the type name as the
appearance attribute. The
CFML tag body is put in a CDATA section in a
cf:attribute name="body" element. The XSL
transforms provided with ColdFusion MX ignore these
elements.
style Optional;
Flash and
XML
Flash:
Must be a style specification in CSS format.
Ignored if the
type attribute is html or text.
For detailed information on specifying Flash styles, see
Chapter 29, “Creating Forms in Macromedia Flash” in
ColdFusion MX Developer’s Guide. Not used with the
spacer type.
XML:
ColdFusion passes the
style attribute to the XML.
ColdFusion skins include the style attribute in the
generated HTML.