HTMLOptionElement

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

Constructor

Option()

Returns a newly created HTMLOptionElement object. It has four parameters: the text to display, text, the value associated, value, the value of defaultSelected, and the value of selected. The last three parameters are optional.

Properties

Inherits properties from its parent, HTMLElement.

HTMLOptionElement.defaultSelected

Has a value of either true or false that shows the initial value of the selected HTML attribute, indicating whether the option is selected by default or not.

HTMLOptionElement.disabled

Has a value of either true or false representing 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.

HTMLOptionElement.form Read only

Is a HTMLFormElement representing the same value as the form of the corresponding <select> element, if the option is a descendant of a <select> element, or null if none is found.

HTMLOptionElement.index Read only

Is a long representing 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.

HTMLOptionElement.label Read only

Is a DOMString that 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.

HTMLOptionElement.selected

Has a value of either true or false that indicates whether the option is currently selected.

HTMLOptionElement.text

Is a DOMString that contains the text content of the element.

HTMLOptionElement.value

Is a DOMString that reflects the value of the value HTML attribute, if it exists; otherwise reflects value of the Node.textContent property.

Methods

Doesn't implement any specific method, but inherits methods from its parent, HTMLElement.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
HTMLOptionElement
1
12
1
5.5
≤12.1
1.2
1
18
4
≤12.1
1
1.0
Option
1
12
1
5.5
≤12.1
1.2
1
18
4
≤12.1
1
1.0
defaultSelected
1
12
1
5.5
≤12.1
3
1
18
4
≤12.1
1
1.0
disabled
1
12
1
5.5
≤12.1
3
1
18
4
≤12.1
1
1.0
form
1
12
1
5.5
≤12.1
3
1
18
4
≤12.1
1
1.0
index
1
12
1
5.5
≤12.1
3
1
18
4
≤12.1
1
1.0
label
1
12
7
1-7
Before Firefox 7 the label property incorrectly returned an empty string if not defined instead of returning the element's text content.
6
≤12.1
3
1
18
7
4-7
Before Firefox 7 the label property incorrectly returned an empty string if not defined instead of returning the element's text content.
≤12.1
1
1.0
selected
1
12
1
5.5
≤12.1
3
1
18
4
≤12.1
1
1.0
text
1
12
1
5.5
≤12.1
3
1
18
4
≤12.1
1
1.0
value
1
12
1
5.5
≤12.1
3
1
18
4
≤12.1
1
1.0

See also

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

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLOptionElement