User Guide

cfinput 243
History
ColdFusion MX 7:
• Added support for button, file, hidden, image, reset, and submit controls.
• Added support for generating Flash and XML controls (specified in the cfform tag).
• Added datefield type (Flash forms only) and the supporting daynames and monthnames
attributes.
• Added bind, enabled, height, label, tooltip, visible, and width attributes for use in
Flash forms.
• Added support for onBlur and onServer validation, including the validateAt attribute.
• Added USdate, range, boolean, email, URL, uuid, guid, maxlength, noblanks, and
submitOnce
validation attribute values.
• Added support for preventing multiple submissions.
• Added the mask attribute.
• Deprecated the passthrough attribute. The tag now supports all HTML input tag attributes
directly.
ColdFusion MX: Changed the
cfform tag preserveData attribute behavior: if it is set to True,
ColdFusion checks radio and check box values only if their value matches the posted value for the
control. (In earlier releases, if the posted value did not match any of the
cfinput check boxes or
radio buttons for the control, the
checked attribute was used.
Attributes
The following table lists attributes that ColdFusion uses directly. The tag also supports all HTML
form tag attributes that are not on this list, and passes them directly to the browser.
Note: Attributes that are not marked as supported in XML are not handled by the skins provided with
ColdFusion MX. They are, however, included in the generated XML.
<em>
Attribute Req/Opt;
Formats
Default Description
name Required;
All
Name for form input element.
type Optional;
All
text The input control type to create:
• button: push button.
• checkbox: check box.
• file: file selector; not supported in Flash.
• hidden: invisible control.
• image: clickable button with an image.
• password: password entry control; hides input values.
• radio: radio button.
• reset: form reset button.
• submit: form submission button.
• text: text entry box.
• datefield: Flash only; date entry field with an
expanding calendar for selecting dates.