cfformitem

<cfformitem
type = "hrule|vrule|spacer"
height = "pixels"
style = "style specification"
visible = "yes|no"
width = "pixels"/>

OR

<cfformitem
type = "html|text|script"
bind = "bind expression"
enabled = "yes|no"
height = "pixels"
style = "style specification"
tooltip = "text"
visible = "yes|no"
width = "pixels">
...text </cfformitem>

Note: You can specify this tag's attributes in an attributeCollection attribute whose value is a structure. Specify the structure name in the attributeCollection attribute and use the tag's attribute names as structure keys.

Note: Attributes that are marked as Flash only are not handled by the skins provided with ColdFusion. They are, however, included in the generated XML in all controls except text and html types.

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.
• script: lets you create functions in Flash forms, which reduces the possibility of reaching the 64 KB limit.

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 ignore these elements.

bind

Optional;Flash

A Flash bind expression that populates the field with information from other form fields. If you use this attribute, ColdFusion ignores any text that you specify in the body of the cftextitem tag. This attribute can be useful if the cfformitem tag is in a cfformgroup type="repeater" tag. For more information, see Flash form data binding in the cfinput tag description.

enabled

Optional;Flash

yes

Boolean value that specifies whether the control is enabled. Disabled text appear in light gray. Has no effect on spacers and rules.

height

Optional;Flash

Height of the item, in pixels. If you omit this attribute, Flash automatically sizes the height. In ColdFusion XSL skins, use the style attribute, instead.

style

Optional;Flash and XML

Flash:

• Must be a style specification in CSS format.

Ignored if the type attribute is html.
For detailed information on specifying Flash styles, see Creating Forms in Flash in the Developing ColdFusion Applications. 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.

tooltip

Optional;Flash

Text to display when the mouse pointer hovers over the control. Has no effect on spacers.

visible

Optional;Flash

yes

Boolean value that specifies whether to show the control. Space that would be occupied by an invisible control is blank. Has no effect on spacers.

width

Optional;Flash

Width of the item, in pixels. If you omit this attribute, Flash automatically sizes the width. In ColdFusion XSL skins, use the style attribute, instead.

<cfformitem type="hrule" />