CFTEXTINPUT | |
Description
Puts a single-line text entry box in a cfform tag and controls its display characteristics. |
|
Category
Forms tags | |
Syntax<cftextinput name = "name" value = "text" required = "Yes" or "No" range = "min_value, max_value" validate = "data_type" onValidate = "script_name" message = "text" onError = "text" size = "integer" font = "font_name" fontSize = "integer" italic = "Yes" or "No" bold = "Yes" or "No" height = "integer" width = "integer" vSpace = "integer" hSpace = "integer" align = "alignment" bgColor = "color" textColor = "color" maxLength = "integer" notSupported = "text"> | |
See also
cfapplet, cfform, cfgrid, cfgridcolumn, cfgridrow, cfgridupdate, cfinput, cfselect, cfslider, cftree, cftreeitem
|
|
Usage
This tag requires the client to download a Java applet. Downloading an applet takes time; therefore, using this tag might be slightly slower than using an HTML form element or the cfinput tag to get the same information. For this tag to work properly. the browser must be JavaScript-enabled. If the following conditions are true, a user's selection from query data that populates this tag's options continues to display after the user submits the form:
For more information, see cfform. 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. |
|
Example <h3>cftextinput Example</h3> cftextinput provides simple validation for text fields in cfform and control over font information displayed in cfform input boxes for text. For example, the field below must not be blank, and provides a client-side message upon erring. <cfform action = "cftextinput.cfm" method = "post"> <cfif IsDefined("form.myInput")> <h3>You entered <cfoutput> #form.myInput#</cfoutput> into the text box </h3> </cfif> <cftextinput name = "myInput" font = "Courier" fontSize = 12 value = "Look, this text is red!" textColor = "FF0000" message = "This field must not be blank" required = "Yes"> <input type = "Submit" name = "" value = "submit"> </cfform> |
NAME | |
Required | |
Name for the cftextinput control. |
VALUE | |
Optional | |
Initial value to display in text control. |
REQUIRED | |
Optional | |
Default value: "No"
|
RANGE | |
Optional | |
Minimum-maximum value range, delimited by a comma. Valid only for numeric data. |
VALIDATE | |
Optional | |
|
ONVALIDATE | |
Optional | |
Custom JavaScript function to validate user input. The form object, input object, and input object value are passed to routine, which should return True if validation succeeds, False otherwise. The validate attribute is ignored. |
PATTERN | |
Required if validate = "regular_expression" | |
JavaScript regular expression pattern to validate input. Omit leading and trailing slashes. |
MESSAGE | |
Optional | |
Message text to display if validation fails. |
ONERROR | |
Optional | |
Custom JavaScript function to execute if validation fails. |
SIZE | |
Optional | |
Number of characters displayed before horizontal scroll bar displays. |
FONT | |
Optional | |
Font name for text. |
FONTSIZE | |
Optional | |
Font size for text. |
ITALIC | |
Optional | |
Default value: "No"
|
BOLD | |
Optional | |
Default value: "No"
|
HEIGHT | |
Optional | |
Default value: "40"
Height of the control, in pixels. |
WIDTH | |
Optional | |
Default value: "200"
Width of the control, in pixels. |
VSPACE | |
Optional | |
Vertical spacing of the control, in pixels. |
HSPACE | |
Optional | |
Horizontal spacing of the control, in pixels. |
ALIGN | |
Optional | |
Alignment of text entry box with respect to adjacent HTML content:
|
BGCOLOR | |
Optional | |
Background color of control. For a hex value, use the form: textColor = "##xxxxxx", where x = 0-9 or A-F; use two pound signs or none.
|
TEXTCOLOR | |
Optional | |
Text color for control. Options: same as for bgcolor attribute. |
MAXLENGTH | |
Optional | |
The maximum length of text entered. |
NOTSUPPORTED | |
Optional | |
Text to display if a page that contains a Java applet-based cfform control is opened by a browser that does not support Java, or has Java support disabled. For example: notSupported = "<b> Browser must support Java to view ColdFusion Java Applets</b>" If no message is specified, this message displays: <b>Browser must support Java to <br> view ColdFusion Java Applets!</b> |