User Guide

cfselect 387
cfselect
Description
Constructs a drop-down list box form control. Used within a cfform tag. You can populate the
list from a query, or by using the HTML
option tag.
Category
Forms tags
Syntax
<cfselect
name = "name"
label = "label"
style = "style specification"
size = "integer"
required = "yes" or "no"
message = "text"
onError = "text"
multiple = "yes" or "no"
query = "queryname"
value = "text"
display = "text">
group = "query column name
queryPosition = "above" or "below"
selected = "value or list"
onKeyUp = "JavaScript or ActionScript"
onKeyDown = "JavaScript or ActionScript"
onMouseUp = "JavaScript or ActionScript"
onMouseDown = "JavaScript or ActionScript"
onChange = "JavaScript or ActionScript"
onClick = "JavaScript or ActionScript"
visible = "Yes" or "No"
enabled = "Yes" or "No"
tooltip = "tip text"
height = "number of pixels" Flash only
width = "number of pixels" Flash only
>
zero or more HTML option tags
</cfselect>
See also
cfapplet
, cfcalendar, cfform, cfformgroup, cfformitem, cfgrid, cfinput, cfslider,
cftextarea, cftree; Chapter 26, “Introduction to Retrieving and Formatting Data,” in
ColdFusion MX Developer’s Guide
History
ColdFusion MX 7:
• Added support for specifying multiple values to the selected attribute.
• Deprecated the passthrough attribute. The tag now supports all HTML select tag
attributes directly.