MACROMEDIA COLFUSION MX 7-CFML, Reference

Page: 415 / 1108

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