HTMLOptionElement

Jump to:
  1. Properties
  2. Methods
  3. Specifications
  4. Browser compatibility
  5. See also

The HTMLOptionElement interface represents <option> elements and inherits all classes and methods of the HTMLElement interface.

Properties

Inherits properties from its parent, HTMLElement.

Name Type Description
defaultSelected Boolean Contains the initial value of the selected HTML attribute, indicating whether the option is selected by default or not.
disabled Boolean Reflects the value of the disabled HTML attribute, which indicates that the option is unavailable to be selected. An option can also be disabled if it is a child of an <optgroup> element that is disabled.
formRead only HTMLFormElement If the option is a descendent of a <select> element, then this property has the same value as the form property of the corresponding HTMLSelectElement object; otherwise, it is null.
indexRead only long The position of the option within the list of options it belongs to, in tree-order. If the option is not part of a list of options, like when it is part of the <datalist> element, the value is 0.
label DOMString Reflects the value of the label HTML attribute, which provides a label for the option. If this attribute isn't specifically set, reading it returns the element's text content.
selected Boolean Indicates whether the option is currently selected.
text DOMString Contains the text content of the element.
value DOMString Reflects the value of the value HTML attribute, if it exists; otherwise reflects value of the Node.textContent property.

Methods

Inherits methods from its parent, HTMLElement.

Option()
Is a constructor creating an HTMLOptionElement object. It has four values: the text to display, text, the value associated, value, the value of defaultSelected, and the value of selected. The last three values are optional.

Specifications

Specification Status Comment
HTML Living Standard
The definition of 'HTMLOptionElement' in that specification.		 Living Standard  
HTML5
The definition of 'HTMLOptionElement' in that specification.		 Recommendation A constructor, Option(), has been added.
The form property can be the null value.
Document Object Model (DOM) Level 2 HTML Specification
The definition of 'HTMLOptionElement' in that specification.		 Obsolete The selected property changed its meaning: it now indicates if the option is currently selected and no longer if it was initally selected.
The defaultSelected property is no longer read-only.
Document Object Model (DOM) Level 1 Specification
The definition of 'HTMLOptionElement' in that specification.		 Obsolete Initial definition

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support YesEdge Full support YesFirefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
defaultSelectedChrome Full support YesEdge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
disabledChrome Full support YesEdge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
formChrome Full support YesEdge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
indexChrome Full support YesEdge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
labelChrome Full support YesEdge Full support 12Firefox Full support 7
Full support 7
No support ? — 7
Notes
Notes Prior to Firefox 7 the label property incorrectly returned an empty string if not defined instead of returning the element's text content.
IE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support 7
Full support 7
No support ? — 7
Notes
Notes Prior to Firefox 7 the label property incorrectly returned an empty string if not defined instead of returning the element's text content.
Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
selectedChrome Full support YesEdge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
textChrome Full support YesEdge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes
valueChrome Full support YesEdge Full support 12Firefox Full support YesIE Full support YesOpera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesEdge Mobile Full support YesFirefox Android Full support YesOpera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support Yes

Legend

Full support  
Full support
See implementation notes.
See implementation notes.

See also

  • The HTML element implementing this interface: <option>.

Document Tags and Contributors

Tags: 
Contributors to this page: sideshowbarker, fisker, ExE-Boss, Sebastianz, libbymc, fscholz, teoli, kscarfone, t0dd.moz, Sheppy, ethertank, Brettz9, BYK, jswisher
Last updated by: sideshowbarker,