Contents

cfinput

Description

Used inside cfform to place radio buttons, checkboxes, or text boxes. Provides input validation for the specified control type.

Category

Other

Implemented

Usage Syntax

<cfinput  
	[autosuggest="String"]
	[autosuggestBindDelay="number"]
	[autosuggestMinLength="number"]
	[delimiter="String"]
	[maxResultsDisplayed="number"]
	[onBindError="String"]
	[showAutosuggestLoadingIcon="Boolean"]
	[sourceForTooltip="String"]
	[typeahead="Boolean"]
	[validateAt="String"]
	[type="String"]
	name="String"
	[value="String"]
	[required="Boolean"]
	[range="String"]
	[validate="String"]
	[bind="String"]
	[bindAttribute="String"]
	[bindOnLoad="Boolean"]
	[border="String"]
	[accept="String"]
	[accesskey="String"]
	[align="String"]
	[alt="String"]
	[checked="String"]
	[daynames="String"]
	[firstDayOfWeek="number"]
	[monthNames="String"]
	[height="String"]
	[width="String"]
	[hspace="String"]
	[label="String"]
	[mask="String"]
	[notab="String"]
	[datafld="String"]
	[datasrc="String"]
	[dataformatas="String"]
	[disabled="String"]
	[ismap="String"]
	[readonly="String"]
	[src="String"]
	[usemap="String"]
	[title="String"]
	[dir="String"]
	[lang="String"]
	[onValidate="String"]
	[pattern="String"]
	[message="String"]
	[onError="String"]
	[size="String"]
	[maxLength="number"]
	[passThrough="Any"]
	[class="String"]
	[id="String"]
	[onBlur="String"]
	[onChange="String"]
	[onClick="String"]
	[onDblclick="String"]
	[onFocus="String"]
	[onKeyDown="String"]
	[onKeyPress="String"]
	[onKeyUp="String"]
	[onMouseDown="String"]
	[onMouseMove="String"]
	[onselect="String"]
	[onMouseUp="String"]
	[onMouseOut="String"]
	[onMouseOver="String"]
	[style="String"]
	[tabIndex="String"]
	[enabled="String"]
	[visible="String"]
	[tooltip="String"]
 />

[] = Optional attribute

Attributes

Name Type Required Default Description
autosuggest String No
autosuggestBindDelay number No
autosuggestMinLength number No
delimiter String No
maxResultsDisplayed number No
onBindError String No
showAutosuggestLoadingIcon Boolean No
sourceForTooltip String No
typeahead Boolean No
validateAt String No
type String No
name String Yes A name for the form input element.
value String No An initial value for the form input element.
required Boolean No Enter Yes or No. Default is No.
range String No Enter a minimum and maximum value range, separated by a comma. Valid only for numeric data.
validate String No
bind String No
bindAttribute String No
bindOnLoad Boolean No
border String No
accept String No
accesskey String No
align String No
alt String No
checked String No
daynames String No
firstDayOfWeek number No
monthNames String No
height String No
width String No
hspace String No
label String No
mask String No
notab String No
datafld String No
datasrc String No
dataformatas String No
disabled String No
ismap String No
readonly String No
src String No
usemap String No
title String No
dir String No
lang String No
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 specified routine, which should return true if validation succeeds and false otherwise. If used, the validate attribute is ignored.
pattern String No The JavaScript regular expression pattern to use to validate the input. Required only if you specify validate = "regular_expression".
message String No Message text to appear if validation fails.
onError String No The name of a JavaScript function you want to execute in the event of a failed validation.
size String No The size of the input control. Ignored if type is Radio or Checkbox.
maxLength number No The maximum length of text entered, if n type is Text.
passThrough Any 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.
class String No the html attribute class
id String No the html attribute id
onBlur String No the html attribute onBlur
onChange String No the html attribute onChange
onClick String No the html attribute onClick
onDblclick String No the html attribute onDblclick
onFocus String No the html attribute onFocus
onKeyDown String No the html attribute onKeyDown
onKeyPress String No the html attribute onKeyPress
onKeyUp String No the html attribute onKeyUp
onMouseDown String No the html attribute onMouseDown
onMouseMove String No the html attribute onMouseMove
onselect String No the html attribute onselect
onMouseUp String No the html attribute onMouseUp
onMouseOut String No the html attribute onMouseOut
onMouseOver String No the html attribute onMouseOver
style String No the html attribute style
tabIndex String No the html attribute tabIndex
enabled String No
visible String No
tooltip String No

Example Usage