HTMLOptionElement
The HTMLOptionElement
interface represents <option>
elements and inherits all classes and methods of the HTMLElement
interface.
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
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 ofdefaultSelected
, and the value ofselected
. 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 initially 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
BCD tables only load in the browser
See also
- The HTML element implementing this interface:
<option>
.