cftextarea

Overview ColdFusion Open BlueDragon Lucee

Puts a multiline text entry box in a cfform tag and controls its display characteristics.

Attributes

Name Required Type Default Description
accept No
accesskey No
align No
alt No
8
basepath No String Path to the directory that contains the rich text editor. The editor configuration files are at the top level of this directory.
bind No String Flash only: A Flex bind expression that populates the field with information from other form fields.
8
bindattribute No String Specifies the HTML tag attribute whose value is set by the bind attribute. You can only specify attributes in the browser's HTML DOM tree, not ColdFusion-specific attributes.
8
bindonload No Boolean false A Boolean value that specifies whether to execute the bind attribute expression when first loading the form.
class No the html attribute class
cols No
dir No
disabled No Boolean false Disables user input, making the control read-only. To disable input, specify disabled without an attribute, or disabled="true". To enable input, omit the attribute or specify disabled="false". Default: false
enabled No Boolean true Flash only: Boolean value specifying whether the control is enabled. A disabled control appears in light gray. The inverse of the diabled attribute. Default: true
8
fontformats No String A comma separated list of the font names to display in the rich text editor Formats selector. The formats specify the HTML tags to apply to typed or selected text.
8
fontnames No String A comma separated list of the font names to display in the rich text editor Font selector.
8
fontsizes No String A comma separated list of the font sizes to display in the rich text editor Size selector. List entries must have the format of numeric font size/descriptive text.
height No Numeric Flash only: The height of the control, in pixels.
hspace No
8
html No Boolean false Boolean value that specifies whether the text area contains HTML. Default: false
id Yes String ID for form input element.
label No String Label to put beside the control on a form.
lang No
maxlength No Numeric The maximum length of text that can be entered. ColdFusion uses this attribute only if you specify maxlength in the validate attribute.
message No String Message text to display if validation fails.
name Yes String Name of the cftextinput control.
8
onbinderror No String The name of a JavaScript function to execute if evaluating a bind expression results in an error. The function must take two attributes: an HTTP status code and a message.
onblur No the html attribute onBlur
onchange No String JavaScript (HTML/XML) or ActionScript (Flash) to run when the control changes due to user action.
onclick No String JavaScript (HTML/XML) to run when the user clicks the control. Not supported for Flash forms.
ondblclick No the html attribute onDblclick
onerror No String Custom JavaScript function to execute if validation fails.
onfocus No the html attribute onFocus
onkeydown No String JavaScript (HTML/XML) or ActionScript (Flash) ActionScript to run when the user presses a keyboard key in the control.
onkeypress No the html attribute onKeyPress
onkeyup No String JavaScript (HTML/XML) or ActionScript (Flash) to run when the user releases a keyboard key in the control.
onmousedown No String JavaScript (HTML/XML) or ActionScript (Flash) to run when the user releases a mouse button in the control.
onmousemove No the html attribute onMouseMove
onmouseout No the html attribute onMouseOut
onmouseover No the html attribute onMouseOver
onmouseup No String JavaScript (HTML/XML) or ActionScript (Flash) to run when the user presses a mouse button in the control.
onselect No the html attribute onselect
onvalidate No String Custom JavaScript function to validate user input. The JavaScript DOM form object, input object, and input object value are passed to routine, which should return True if validation succeeds, False otherwise. If you specify this attribute, ColdFusion ignores the validate attribute.
passthrough No HTML attributes that are not explicitly supported by cfinput. If you specify an attribute and value, they are passed to the HTML code generated for the cfinput tag.
pattern No String JavaScript regular expression pattern to validate input. Omit leading and trailing slashes. ColdFusion uses this attribute only if you specify regex in the validate attribute.
range No String Minimum and maximum numeric allowed values. ColdFusion uses this attribute only if you specify range in the validate attribute. If you specify a single number or a single number a followed by a comma, it is treated as a minimum, with no maximum. If you specify a comma followed by a number, the maximum is set to the specified number, with no minimum.
readonly No
required No Boolean false - true: the field must contain text. - false: the field can be empty. Default: false
8
richtext No Boolean false A Boolean value specifying whether this control is a rich text editor with tool bars to control the text formatting.
rows No
9
secureUpload No Boolean If true, enables secure upload using FCKeditor.For secure upload, you must havesessionManagement set to yes. Secure upload does not work if sessionManagement is set to false.
8
skin No String default Specifies the skin to be used for the rich text editor. By default, the valid values are Default, silver, and office2003. You can also create custom skins that you can then specify in this attribute.
8
sourcefortooltip No String The URL of a page to display as a tool tip. The page can include CFML and HTML to control the contents and format, and the tip can include images.If you specify this attribute, an animated icon appears with the text "Loading..." while the tip is being loaded.
style No String In HTML or XML format forms, ColdFusion passes the style attribute to the browser or XML. In Flash format forms, must be a style specification in CSS format, with the same syntax and contents as used in Macromedia Flex for the corresponding Flash element.
8
stylesxml No String The path of the file that defines the styles in the rich text editor Styles selector. Relative paths start at the directory that contains the fckeditor.html file, normally cf_webRoot/CFIDE/scripts/ajax/FCKeditor/editor.
tabindex No the html attribute tabIndex
8
templatesxml No String The pathof the file that defines the templates that are displayed when you click the rich text editor Templates icon.
title No
8
toolbar No String Default Specifies the rich text editor toolbar. By default, the valid values for this attribute are: Default, a complete set of controls, and Basic, a minimal configuration. You can add configurations. This attribute's value is case sensitive.
8
toolbaronfocus No Boolean A Boolean value that specifies whether the rich text editor toolbar expands and displays its controls only when the rich text editor has the focus.
tooltip No String Flash only: Text to display when the mouse pointer hovers over the control.
validate No String The type or types of validation to do. Available validation types and algorithms depend on the format. For details, see the Usage section of the cfinput tag reference.
validateat No String onSubmit How to do the validation. For Flash format forms, onSubmit and onBlur are identical; validation is done on submit. For multiple values, use a comma-delimited list. For details, see the Usage section of the cfinput tag reference. Default: onSubmit
value No String Initial value to display in text control. You can specify an initial value as an attribute or in the tag body, but not in both places. If you specify the value as an attribute, you must put the closing cftextarea tag immediately after the opening cftextarea tag, with no spaces or line feeds between, or place a closing slash at the end of the opening cftextarea tag. For example:
visible No Boolean true Flash only: Boolean value specifying whether to show the control. Space that would be occupied by an invisible control is blank. Default: true
width No Numeric Flash only: The width of the control, in pixels.
8
wrap No String * hard: wraps long lines, and sends the carriage return to the server. * off: does not wrap long lines. * physical: wraps long lines, and transmits the text at all wrap points. * soft: wraps long lines, but does not send the carriage return to the server. * virtual: wraps long lines, but does not send the carriage return to the server.