User Guide

cfinput 203
• class
• id
• onBlur
• onChange
• onClick
• onDblclick
• onFocus
• style
• tabIndex
Usage
If the cfform preserveData attribute is true and the form posts back to the same page, the
posted value of the cfinput control is used, instead of its Value or Checked attribute.
If
cfinput check box or radio type values match the submitted value for the control, ColdFusion
checks their values. If no value matches, nothing is checked.
To add other HTML <input> tag attributes and values to this tag, use the
passThrough attribute.
They are passed through ColdFusion to the browser when creating a form. The supported
HTML attributes are: CLASS, ID, MAXLENGTH, MESSAGE, ONBLUR, ONCHANGE,
ONCLICK, ONDBLCLICK, ONFOCUS, SIZE, STYLE, and TABINDEX.
If you specify a value in quotation marks, you must escape them; for example,
passThrough = "readonly = " "YES " " "
For more information, see cfform on page 132. For information on using JavaScript regular
expressions with this tag, see Chapter 27, “Building Dynamic Forms,” in Developing ColdFusion
MX Applications.
Example
<!--- this example shows the use of cfinput within a cfform to ensure simple
validation of text items --->
<cfform action = "cfinput.cfm">
<!--- phone number validation --->
Phone Number Validation (enter a properly formatted phone number): <br>
<cfinput
type = "Text" name = "MyPhone"
message = "Enter telephone number,formatted xxx-xxx-xxxx (e.g.
617-761-2000)"
validate = "telephone" required = "Yes">
<font size = -1 color = red>Required</font>
<!--- zip code validation --->
<p>Zip Code Validation (enter a properly formatted zip code):<br>
<cfinput
type = "Text" name = "MyZip"
message = "Enter zip code, formatted xxxxx or xxxxx-xxxx"
validate = "zipcode" required = "Yes">
<font size = -1 color = red>Required</font>
<!--- range validation --->
<p>Range Validation (enter an integer from 1 to 5): <br>
<cfinput
type = "Text" name = "MyRange" range = "1,5"
message = "You must enter an integer from 1 to 5"
validate = "integer" required = "No">
<!--- date validation --->
<p>Date Validation (enter a properly formatted date):<br>
<cfinput
type = "Text" name = "MyDate"