Programming ColdFusion MX, 2nd Edition

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.

display=" text "

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

message=" text "

Text to appear if validation fails. Optional.

multiple="Yes|No"

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

onerror=" function_name "

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

passthrough=" HTML_attributes "

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

query=" query_name "

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

required="Yes|No"

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

selected=" column_value "

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

size=" integer "

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

value=" text "

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