Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Our volunteers haven't translated this article into فارسی yet. Join us and help get the job done!

In a Web form, the HTML <option> element is used to create a control representing an item within a <select>, an <optgroup> or a <datalist> HTML5 element.

Content categories None.
Permitted content Text with eventually escaped characters (like &eacute;).
Tag omission The start tag is mandatory. The end tag is optional if this element is immediately followed by another <option> element or an <optgroup>, or if the parent element has no more content.
Permitted parent elements A <select>, an <optgroup> or a <datalist> element.
DOM interface HTMLOptionElement

Attributes

This element includes the global attributes.

disabled
If this Boolean attribute is set, this option is not checkable. Often browsers grey out such control and it won't receive any browsing event, like mouse clicks or focus-related ones. If this attribute is not set, the element can still be disabled if one its ancestors is a disabled <optgroup> element.
label
This attribute is text for the label indicating the meaning of the option. If the label attribute isn't defined, its value is that of the element text content.
selected
If present, this Boolean attribute indicates that the option is initially selected. If the <option> element is the descendant of a <select> element whose multiple attribute is not set, only one single <option> of this <select> element may have the selected attribute.
value
The content of this attribute represents the value to be submitted with the form, should this option be selected. If this attribute is omitted, the value is taken from the text content of the option element.

Examples

See <select> for examples.

Specifications

Specification Status Comment
WHATWG HTML Living Standard
The definition of '<option>' in that specification.
Living Standard  
HTML5
The definition of '<option>' in that specification.
Recommendation  
HTML 4.01 Specification
The definition of '<option>' in that specification.
Recommendation Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 1.0 1.0 (1.7 or earlier)[1][2] (Yes) (Yes) (Yes)
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support (Yes) 1.0 (1.0)[1] (Yes) (Yes) (Yes)

[1] Gecko doesn't display the value of the label attribute as option text if element's content is empty. See bug 1205213.

[2] Historically, Firefox has allowed keyboard and mouse events to bubble up from the <option> element to the parent <select> element. This doesn't happen in Chrome, however, although this behavior is inconsistent across many browsers. For better Web compatibility (and for technical reasons), when Firefox is in multi-process mode and the <select> element is displayed as a drop-down list. The behavior is unchanged if the <select> is presented inline and it has either the multiple attribute defined or a size attribute set to more than 1. Rather than watching <option> elements for events, you should watch for {event("change")}} events on <select>. See bug 1090602 for details.

See also

Document Tags and Contributors

 Last updated by: david-mark,