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 é). |
| 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
labelattribute 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 whosemultipleattribute is not set, only one single<option>of this<select>element may have theselectedattribute. 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
- Other form-related elements:
<form>,<legend>,<label>,<button>,<select>,<datalist>,<optgroup>,<fieldset>,<textarea>,<keygen>,<input>,<output>,<progress>and<meter>.