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 |
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. |
cfapplet, cfform, cfformgroup, cfgrid, cfinput, cfselect, cfslider, cftextarea, cftree, Adding text, images, rules, and space with the cfformitem tag in Building Flash forms in the Developing ColdFusion Applications
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.
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. |
Attribute |
Req/Opt; formats |
Default |
Description |
---|---|---|---|
type |
Required;Flash and XML |
|
Flash:
|
|
|
|
XML:
|
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:
Ignored if the type attribute is 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. |
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 Developing ColdFusion Applications.
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.
Sign in to your account