Cfselect - MACROMEDIA COLDFUSION MX 61-CFML Reference

cfselect

Description
Constructs a drop-down list box form control. Used within a
You can populate the list from a query, or by using the HTML
Category
Forms tags
Syntax
<cfselect
name = "name"
required = "Yes" or "No"
message = "text"
onError = "text"
size = "integer"
multiple = "Yes" or "No"
query = "queryname"
selected = "column_value"
value = "text"
display = "text"
passThrough = "HTML_attributes">
</cfselect>
See also
cfapplet, cfform, cfgrid, cfinput, cfgridcolumn, cfgridrow, cfgridupdate,
cfslider, cftextinput, cftree,
Attributes
Attribute Req/Opt
name Required
size Optional
required Optional
message Optional
onError Optional
multiple Optional
query Optional
selected Optional
312 Chapter 2: ColdFusion Tags
cftreeitem
Default Description
Name of the select form element
1 Number of entries to display at one time. The default, 1,
displays a drop-down list. Any other value displays a list box
with number of entries visible at one time.
size
No • Yes: a list element must be selected when form is submitted.
Note: This attribute has no effect if you omit the
or set it to 1 because the browser always submits the displayed
item.
• No
Message to display if
made.
Custom JavaScript function to execute if validation fails
No • Yes: allow selecting multiple elements in drop-down list
• No
Name of query to populate drop-down list.
A list of option values to preselect in the selection list. This
attribute applies only if list items are generated from a query.
The
cfform preservedata
value.
tag.
cfform
tag.
option
and no selection is
required = "Yes"
attribute value can override this
attribute
size