MACROMEDIA COLDFUSION 4.5-CFML LANGUAGE, Reference

Page: 213 / 608

Chapter 1: ColdFusion Tags 189
CFSELECT
Used inside CFFORM , CFSELECT allows you to construct a drop-down list box form
control. You can populate the drop-down list box from a query, or using the OPTION
tag. Use OPTION elements to populate lists. Syntax for the OPTION tag is the same as
for its HTML counterpart.
Syntax
<CFSELECT NAME="name"
REQUIRED="Yes/No"
MESSAGE="text"
ONERROR="text"
SIZE="integer"
MULTIPLE="Yes/No"
QUERY="queryname"
SELECTED="column_value"
VALUE="text"
DISPLAY="text"
PASSTHROUGH="HTML_attributes">
</CFSELECT>
NAME
Required. A name for the form you are creating.
SIZE
Optional. Size of the drop-down list box in number of entries.
REQUIRED
Optional. Yes or No. If Yes, a list element must be selected when the form is
submitted. Default is No.
MESSAGE
Optional. Message that appears if REQUIRED="Yes" and no selection is made.
ONERROR
Optional. The name of a valid JavaScript function you want to execute in the event
of a failed validation.
MULTIPLE
Optional. Yes or No. Yes permits selection of multiple elements in the drop-down
list box. The default is No.
QUERY
Optional. Name of the query to be used to populate the drop-down list box.
SELECTED
Optional. Enter a value matching at least one entry in VALUE to preselect the entry
in the drop-down list box.