Webpage Workshop: Home » XHTML 1.0 language reference » Selection list

Selection list

This element is used to create a list of options within a form. The exact format of this element dictates whether the user can pick one or more options, and also whether the element will be rendered as a drop-down list of a scrollable selection.

<select
    class="class name(s)"
    dir="ltr | rtl"
    disabled
    id="unique identifier"
    lang="language code"
    multiple
    name="identifier"
    size="number"
    style="style information"
    tabindex="number"
    title="text"
>
</select>

Key:
‡ = Required attribute
** = Transitional only

Explanation of attributes

class: used to state which class(es) the element belongs to. It is possible to indicate more than one class for an element by separating each class name with a space character. This attribute is normally used in combination with a stylesheet in order to associate the elements with particular styles defined within the stylesheet.

dir: used to set the direction of the text in combination with the language set in the lang attribute. The available values are "ltr" (left to right) and "rtl" (right to left), with the default value being "ltr".

disabled: this attribute is used to disable a selection list. This means that it cannot be selected by the user, and when the form is submitted the value of this field will not be sent to the server.

id: used to specify a unique alphanumeric identifier to the element. This is usually used in combination with stylesheets in order to apply a style to one particular instance of an element. Only one element, regardless of type, can be given a particular id.

lang: used to indicate the language being used in the text contained within the element. The value of this attribute takes on the form of the ISO standard lanuage abbreviations found in RFC 3066. A list of these codes can be found on the ISO language codes page.

multiple: when this attribute is used, the user is allowed to choose more than one option in the selection list.

name: this attribute is used to identify selection list. The value of this attribute is typically used by the processing script when the form is submitted.

size: this ttribute is used to specify the number of options that should be visable at once. When the multiple attribute is used, this denotes the size, in lines, of the selection list.

style: used to specify an inline style to apply to the element. The styles defined here override the styles declared in the header section.

tabindex: used to define the elements position in the tabbing order of the document. This attribute contains a number, which a traversed in order by using the TAB key.

title: used to define an advisory text that may be displayed as a tooltip when a mouse is used to hover over the element.

Event handlers

The following event handlers are defined for this element:

Basic example

<select name="searchengine">
    <option value="Google">Google</option>
    <option value="Yahoo!">Yahoo!</option>
    <option value="AllTheWeb">AllTheWeb</option>
</select>

The above code will display something like:

Compatibility

Description: Support of selection list and attributes in various browsers
Test Internet Explorer 6+ Netscape 4 Mozilla and Netscape 6+ Opera 6+ MSN TV (WebTV) Konqeuror 3.0+
Basic element support  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: class  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: dir  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: disabled  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: id  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: lang  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: multiple  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: name  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: size  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: style  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: tabindex  Yes  Yes  Yes  Yes  Yes  Yes 
Attribute: title  Yes  Yes  Yes  Yes  No  Yes 

Key:
The browser icons are explained in the below list:
Internet Explorer 6+ = Microsoft Internet Explorer 6+
Netscape 4 = Netscape Communicator 4
Mozilla and Netscape 6+ = Mozilla and Netscape Navigator 6+
Opera 7+ = Opera 7+
MSN TV (WebTV) = MSN TV (aka. WebTV)
Konqeuror 3.0+ = Konqueror 3.0+