<cfselect>

Used inside <cfform>, cfselect lets you 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.

The syntax for the option tag is the same as for its HTML counterpart.

This tag must have a body.

This tag is also supported within <cfscript>

Requires Extension: Form Tags for Jakarta EE (Lucee 7+)


		<cfselect
    datafld=string
    caseSensitive=boolean
    datasrc=string
    dataformatas=string
    disabled=string
    multiple=string
    title=string
    dir=string
    lang=string
    onmousedown=string
    onmouseup=string
    onmouseover=string
    onmousemove=string
    onmouseout=string
    onkeypress=string
    onkeyup=string
    onkeydown=string
    name=string
    size=number
    required=boolean
    message=string
    onError=string
    query=string
    selected=string
    value=string
    display=string
    passThrough=any
    class=string
    id=string
    onBlur=string
    onChange=string
    onClick=string
    onDblclick=string
    onFocus=string
    style=string
    tabIndex=string
    label=string
    enabled=boolean
    group=string
    height=number
    queryPosition=string
    tooltip=string
    visible=boolean
    width=number
    editable=boolean
><!--- body ---></cfselect>

Attribute	Description
datafld _{string, optional}	edit passed through to form tag created, only used for type html.
caseSensitive _{boolean, optional}	edit is compare for selected case sensitive or not
datasrc _{string, optional}	edit passed through to form tag created, only used for type html.
dataformatas _{string, optional}	edit passed through to form tag created, only used for type html.
disabled _{string, optional}	edit passed through to form tag created, only used for type html.
multiple _{string, optional}	edit Yes or No. Yes permits selection of multiple elements in the drop-down list box. The default is No.
title _{string, optional}	edit passed through to form tag created, only used for type html.
dir _{string, optional}	edit passed through to form tag created, only used for type html.
lang _{string, optional}	edit passed through to form tag created, only used for type html.
onmousedown _{string, optional}	edit JavaScript to run when the user releases a mouse button in the control.
onmouseup _{string, optional}	edit JavaScript to run when the user presses a mouse button in the control.
onmouseover _{string, optional}	edit passed through to form tag created, only used for type html.
onmousemove _{string, optional}	edit passed through to form tag created, only used for type html.
onmouseout _{string, optional}	edit passed through to form tag created, only used for type html.
onkeypress _{string, optional}	edit passed through to form tag created, only used for type html.
onkeyup _{string, optional}	edit JavaScript to run when the user releases a keyboard key in the control.
onkeydown _{string, optional}	edit JavaScript to run when the user depresses a keyboard key in the control.
name _{string, required}	edit Name of the form you are creating.
size _{number, optional}	edit Number of entries in the drop-down list.
required _{boolean, optional}	edit Yes or No. If Yes, a list element must be selected when the form is submitted, and the size of the drop-down list must be at least two. Default is No.
message _{string, optional}	edit Message that displays if required = 'Yes' and no selection is made.
onError _{string, optional}	edit The name of a valid JavaScript function to execute in the event of a failed validation.
query _{string, optional}	edit Name of the query to be used to populate the drop-down list box.
selected _{string, optional}	edit A value matching at least one entry in value to preselect the entry in the drop-down list box.
value _{string, optional}	edit The query column value for the list element. Used with the query attribute.
display _{string, optional}	edit The query column displayed. Defaults to the value of value. Used with the query attribute.
passThrough _{any, optional}	edit HTML attributes that are not explicitly supported by cfselect. If you specify an attribute and its value, the attribute and its value are passed to the HTML code that is generated for the cfselect tag.
class _{string, optional}	edit passed through to form tag created, only used for type html.
id _{string, optional}	edit ID for form input element.
onBlur _{string, optional}	edit
onChange _{string, optional}	edit JavaScript to run when the control changes due to user action.
onClick _{string, optional}	edit JavaScript to run when the user clicks the control.
onDblclick _{string, optional}	edit passed through to form tag created, only used for type html.
onFocus _{string, optional}	edit passed through to form tag created, only used for type html.
style _{string, optional}	edit Lucee passes the style attribute to the browser.
tabIndex _{string, optional}	edit passed through to form tag created, only used for type html.
enabled _{boolean, optional}	edit Flash only: Boolean value specifying whether to show the control. Space that would be occupied by an invisible control is blank. Default: true
group _{string, optional}	edit Query column to use to group the items in the drop-down list into a two-level hierarchical list.
queryPosition _{string, optional}	edit If you populate the options list with a query and use HTML option child tags to specify additional entries, determines the location of the items from the query relative to the items from the option tags: above: Put the query items above the options items. below: Put the query items below the options items. Default: above

Unimplemented Attribute(s)

Attribute	Description
label _{string, optional}	edit Label to put next to the control on a Flash or XML-format form. * unimplemented *
height _{number, optional}	edit The height of the control, in pixels. * unimplemented *
tooltip _{string, optional}	edit Flash only: Text to display when the mouse pointer hovers over the control. * unimplemented *
visible _{boolean, optional}	edit Flash only: Boolean value specifying whether to show the control. Space that would be occupied by an invisible control is blank. Default: true * unimplemented *
width _{number, optional}	edit The width of the control, in pixels. * unimplemented *
editable _{boolean, optional}	edit Boolean value specifying whether you can edit the contents of the control. * unimplemented *

Examples

edit

<cfform name="mycfform">
    -- year --
    <br />
    <cfselect name="year" enabled=true style="color:blue;" size=2>
        <option name="0" selected=true>--2024--</option>
        <option name="1">--2023--</option>
        <option name="3">--2022--</option>
        <option name="2">--2021--</option>
    </cfselect> <br />
    -- color --
    <br />
    <cfselect name="color" >
        <option name="0">--red--</option>
        <option name="1">--green--</option>
        <option name="2">--blue--</option>
    </cfselect>
</cfform>

<cfselect>

Unimplemented Attribute(s)

Examples

See also