HTMLOptionElement
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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.
Instance 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-
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-
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-
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
orfalse
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 theNode.textContent
property.
Instance methods
Doesn't implement any specific method, but inherits methods from its parent, HTMLElement
.
Specifications
Specification |
---|
HTML Standard # htmloptionelement |
Browser compatibility
BCD tables only load in the browser
See also
- The HTML element implementing this interface:
<option>
. - The
HTMLOptionsCollection
interface.