Programming ColdFusion

Name

CFSELECT

Synopsis

<CFFORM>
  <CFSELECT> 
  ...
</CFFORM>

Creates a Java select box control to use in a CFFORM block.

Attributes

NAME=" name "

The form-field name for the select box control. Required.

REQUIRED="Yes|No"

Whether or not the select box control requires a value before being submitted. Optional. The default is No.

MESSAGE=" text "

Text to appear if validation fails. Optional.

ONERROR=" function_name "

The name of a JavaScript function that should be executed if validation fails for any reason. Optional.

SIZE=" integer "

The size of the drop-down box in terms of number of entries. Optional.

MULTIPLE="Yes|No"

Whether or not multiple item selections should be allowed. Optional. The default is No.

QUERY=" query_name "

A query to use for populating the drop-down box. Optional.

SELECTED=" column_value "

A value that matches at least one VALUE that is automatically selected when the template is called. Optional.

VALUE=" text "

The field from QUERY to use to fill in the option values of the select box. Optional.

DISPLAY=" text "

An alternate field from the query (other than VALUE) to display in the select box. Optional. The default is VALUE.

PASSTHROUGH=" HTML_attributes "

Any additional HTML attributes you want to pass that aren’t directly supported by the CFSELECT tag. Optional.