W3cubDocs

/Web APIs

HTMLOptionElement

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

EventTarget Node Element HTMLElement HTMLOptionElement

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.

Instance 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

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

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

A string 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

A string that contains the text content of the element.

HTMLOptionElement.value

A string that reflects the value of the value HTML attribute, if it exists; otherwise reflects value of the Node.textContent property.

Instance 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
Option 1 12 1
5.5Before Internet Explorer 9, the outerHTML of elements lose their text when constructing with new Option().
≤12.1 1.2 4.4 18 4 ≤12.1 1 1.0
HTMLOptionElement 1 12 1 5.5 ≤12.1 1.2 4.4 18 4 ≤12.1 1 1.0
defaultSelected 1 12 1 5.5 ≤12.1 3 4.4 18 4 ≤12.1 1 1.0
disabled 1 12 1 5.5 ≤12.1 3 4.4 18 4 ≤12.1 1 1.0
form 1 12 1 5.5 ≤12.1 3 4.4 18 4 ≤12.1 1 1.0
index 1 12 1 5.5 ≤12.1 3 4.4 18 4 ≤12.1 1 1.0
label 1 12 7
1–7Before 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 4.4 18 7
4–7Before 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 4.4 18 4 ≤12.1 1 1.0
text 1 12 1 5.5 ≤12.1 3 4.4 18 4 ≤12.1 1 1.0
value 1 12 1 5.5 ≤12.1 3 4.4 18 4 ≤12.1 1 1.0

See also

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