User Guide

cftextarea 415
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.
Usage
For this tag to work properly in HTML format. the browser must be JavaScript-enabled.
If you put text in the tag body, the control displays all text characters between the
cftextarea
opening and closing tags; therefore, if you use line feeds or white space to format your source text,
they appear in the control.
If the
cfform preserveData attribute is "yes", and the form posts back to the same page, the
posted value (not the value of the
value attribute) of the cftextinput control is used.
Validation
For a detailed description of the validation attribute and the types of validation supported by
ColdFusion, see the Usage section of the
cfinput tag reference. For more details on ColdFusion
MX validation techniques, see Chapter 28, “Validating Data” in ColdFusion MX Developer’s
Guide.
Flash form data binding
The bind attribute lets you populate form fields using the contents of other form fields. To
specify text from another field in a
cftextarea bind attribute, use the following format:
{sourceTagName.text}
For example, the following line uses the value of the text that the user enters in the from the
userName field in the greeting in the comment text box. The user can change or replace this
message with a typed entry.
<cfformitem type="text">
Enter your name here</cfformitem>
<cftextarea name="userName" height="20" Width="500"/>
<cftextarea name="comment" html height="300" Width="500"
enabled Optional;
Flash
Yes Boolean value specifying whether the control is enabled.
A disabled control appears in light gray. The inverse of the
disabled attribute.
visible Optional;
Flash
Yes Boolean value specifying whether to show the control.
Space that would be occupied by an invisible control is
blank.
tooltip Optional;
Flash
Text to display when the mouse pointer hovers over the
control.
height Optional;
Flash
The height of the control, in pixels.
width Optional;
Flash
The width of the control, in pixels.
Attribute Req/Opt;
Format
Default Description