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"
pattern = "Java regular expression"
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
|
|
History
|
ColdFusion MX 6.1: Changed the validate = "creditcard" option requirements: the text entry must have 13-16 digits.
|
|
|
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:
- The cfform preserveData attribute is set to "Yes"
- The cfform action attribute posts to the same page as the form itself (this is the default), or the action page has a form that contains controls with the same names as corresponding controls on the user entry 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>
|