Tags · Functions · Objects
Lucee Tag Reference
Choose a tag:

Tag <CFTEXTINPUT>

This Tag is deprecated
Lets you place a single-line text entry box in a cfform. The tag also gives you control over font characteristics.

Body

This tag can't have a body.

Example

	<cftextinput
		[align="string"]
		[bgcolor="string"]
		[bold="boolean"]
		[font="string"]
		[fontsize="number"]
		[height="number"]
		[hspace="number"]
		[italic="boolean"]
		[maxlength="number"]
		[message="string"]
		name="string"
		[notsupported="string"]
		[onerror="string"]
		[onvalidate="string"]
		[range="string"]
		[required="boolean"]
		[size="number"]
		[textcolor="string"]
		[validate="boolean"]
		[value="string"]
		[vspace="number"]
		[width="number"]>
	

Attributes

The attributes for this tag are fixed. Except for the following attributes no other attributes are allowed.
Name Type Required Description
align string No Alignment value. 
bgcolor string No Background color of the control. 
bold boolean No Yes for boldface text, No for medium text. Default is No. 
font string No Font name for text. 
fontsize number No Font size for text. 
height number No Height value of the control, in pixels. 
hspace number No Horizontal spacing of the control, in pixels. 
italic boolean No Yes for italicized text, No for normal text. Default is No. 
maxlength number No The maximum length of text entered. 
message string No Message text to display if validation fails. 
name string Yes A name for the cftextinput control. 
notsupported string No The text to display if the page containing a Java applet-based
cfform control is opened by a browser that does not support Java or has Java support disabled. 
onerror string No Name of a JavaScript function to execute in the event of a failed validation. 
onvalidate string No The name of a JavaScript function used to validate user input. The form object, input object,
and input object value are passed to the routine, which should return TRUE if validation succeeds and
FALSE otherwise. When used, the validate attribute is ignored. 
range string No Minimum value, maximum value range, separated by a comma. Valid only for numeric data. 
required boolean No Yes or No. If Yes, the user must enter or change text. Default is No. 
size number No Number of characters displayed before horizontal scroll bar displays. 
textcolor string No Text color for the control. See bgColor for color options. 
validate boolean No date: verifies format mm/dd/yy.
eurodate: verifies date format dd/mm/yyyy.
time: verifies time format hh:mm:ss.
float: verifies floating point format.
integer: verifies integer format.
telephone: verifies telephone format ###-###-####. The
separator can be a blank. Area code and exchange must
begin with digit 1 - 9.
zipcode: verifies, in U.S. formats only, 5- or 9-digit
format #####-####. The separator can be a blank.
creditcard: strips blanks and dashes; verifies number using
mod10 algorithm. Number must have 13-16 digits.
social_security_number: verifies format ###-##-####. The
separator can be a blank.
regular_expression: matches input against pattern
attribute. 
value string No Initial value that displays in the text control. 
vspace number No Vertical spacing of the control, in pixels. 
width number No Width value of the control, in pixels.