MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 388 / 1108

388 Chapter 2: ColdFusion Tags
•
Added
on
-prefixed attributes.
•
Added
enabled
,
group
,
height
,
label
,
queryPosition
,
tooltip
,
visible
, and
width
attributes.
Attributes
The following table lists attributes that ColdFusion uses directly. The tag also supports all HTML
select
tag attributes that are not on this list, and passes them directly to the browser.
Note: Attributes that are marked as Flash only are not handled by the skins provided with
ColdFusion MX. They are, however, included in the generated XML.
Attribute Req/Opt;
Format Default Description
name Required;
All Name of the select form element.
label Optional;
Flash and
XML Label to put next to the control on a Flash or XML-format
form.
style Optional;
All In HTML or XML format forms, ColdFusion passes the
style attribute to the browser or XML.
In Flash format, must be a style specification in CSS
format, with the same syntax and contents as used in
Macromedia Flex for the corresponding Flash element.
size Optional;
All 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
size
number of entries visible at one time.
required Optional;
All No
•
Yes: a list element must be selected when the form is
submitted.
Note: This attribute has no effect if you omit the
size
attribute or set it to 1, because the browser always submits
the displayed item. You can work around this issue: format
forms by having an initial
option
tag with value=" " (note the
space character between the quotation marks).
•
No
message Optional;
All Message to display if
required = "Yes"
and no selection is
made.
onError Optional;
HTML and
XML Custom JavaScript function to execute if validation fails.
multiple Optional;
All No
•
Yes: allows selecting multiple elements in drop-down list.
•
No
query Optional;
All Name of query to populate drop-down list.
value Optional;
All Query column to use for the value of each list element.
Used with the
query
attribute.