Inserts a horizontal line, a vertical line, a spacer, or text in a Flash form. Used in the cfform or cfformgroup tag body for Flash and XML forms. Ignored in HTML forms.
<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>
cfapplet, cfform, cfformgroup, cfgrid, cfinput, cfselect, cfslider, cftextarea, cftree, "Adding text, images, rules, and space with the cfformitem tag" in "Adding text, images, rules, and space with the cfformitem tag" in the ColdFusion Developer's Guide
ColdFusion MX 7.01: Added the "script" value for type attribute.
ColdFusion MX 7: Added tag
The following table lists the attributes and their behavior in Flash forms. For XML format, if not otherwise noted, the attribute is passed to the XML but is not interpreted by the basic XSL style sheet provided with ColdFusion.
Attribute Req/Opt; formats Default Description type Required; Flash and XML Flash: XML: 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 width. In ColdFusion XSL skins, use the style attribute, instead. style Optional; Flash and XML Flash: For detailed information on specifying Flash styles, see "Creating Forms in Flash" in the ColdFusion Developer's Guide. Not used with the spacer type. XML: 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.
Usage
This tag requires an end tag or a slash before the closing end character of the opening tag, as the following example shows:
<cfformitem type="hrule" />
For more information on using this tag in Flash forms, see "Creating Forms in Flash" in the ColdFusion Developer's Guide.
The following example shows a simple Flash form by using horizontal rules and text:
<h3>cfformitem Example</h3> <cfform name="myform" height="450" width="500" format="Flash" > <cfformitem type="hrule" /> <cfformitem type="text"> This simple form has two hrule cfformitem tags around the cfformitem tag that contains this text. </cfformitem> <cfformitem type="hrule" /> </cfform>
For a more complex form, see cfformgroup.