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
- Is a
Boolean
that contains the initial value of theselected
HTML attribute, indicating whether the option is selected by default or not. HTMLOptionElement.disabled
- Is a
Boolean
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
- Is a
Boolean
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 initally 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>
.