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 ofdefaultSelected
, and the value ofselected
. The last three parameters are optional.
Properties
Inherits properties from its parent, HTMLElement
.
HTMLOptionElement.defaultSelected
-
Has a value of either
true
orfalse
that shows the initial value of theselected
HTML attribute, indicating whether the option is selected by default or not. HTMLOptionElement.disabled
-
Has a value of either
true
orfalse
representing the value of thedisabled
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 theform
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 is0
. -
HTMLOptionElement.label
Read only -
Is a
DOMString
that reflects the value of thelabel
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
orfalse
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 thevalue
HTML attribute, if it exists; otherwise reflects value of theNode.textContent
property.
Methods
Doesn't implement any specific method, but inherits methods from its parent, HTMLElement
.
Specifications
Specification |
---|
HTML Standard (HTML) # htmloptionelement |
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