HTMLOptionElement - 表示 <option> 元素
HTMLOptionElement
接口表示 <option>
元素,并继承 HTMLElement
接口的所有类和方法。
属性
从其父接口 HTMLElement
继承了属性。
HTMLOptionElement.defaultSelected
一个 Boolean
,包含 selected
HTML 属性的初始值,指示默认情况下是否选中了该选项。
HTMLOptionElement.disabled
一个 Boolean
,表示 disabled
HTML 属性的值,指示该选项不可用。如果该元素是禁用的 <optgroup>
元素的子元素,也可以禁用该元素。
HTMLOptionElement.form
只读
一个 HTMLFormElement
,如果该选项是 <select>
元素的后代,表示与相应 <select>
元素的 form
值相同的值,如果不是,则为 null
。
HTMLOptionElement.index
只读
一个 long
,以树顺序表示该选项在其所属的选项列表中的位置。如果该选项不是选项列表的一部分,例如当它是 <datalist>
元素的一部分时,则值为 0
。
HTMLOptionElement.label
只读
一个 DOMString
,表示 label
HTML 属性的值,该属性表示该元素的标签。如果未特别设置此属性,则读取该属性将返回元素的文本内容。
HTMLOptionElement.selected
一个 Boolean
,指示当前是否选择了该选项。
HTMLOptionElement.text
一个 DOMString
,其中包含元素的文本内容。
HTMLOptionElement.value
一个 DOMString
,表示 value
HTML 属性的值(如果存在);如果不存在,则表示 Node.textContent
属性的值。
方法
从其父接口 HTMLElement
继承了方法。
Option()
表示创建 HTMLOptionElement
对象的构造函数。它具有四个值:要显示的文本,text
,关联的值,value
,defaultSelected
的值和 selected
的值。后面三个值是可选的。
规范
规范 | 状态 | 备注 |
---|---|---|
HTML Living Standard HTMLOptionElement 的定义 |
现行的标准 | - |
HTML5 HTMLOptionElement 的定义 |
推荐 | 添加了一个构造函数 Option() 。form 属性可以是 null 值。 |
Document Object Model (DOM) Level 2 HTML Specification HTMLOptionElement 的定义 |
已过时 | selected 属性改变了它的含义:它现在指示该选项当前是否被选中,而不再是最初被选中的。 defaultSelected 属性不再是只读的。 |
Document Object Model (DOM) Level 1 Specification HTMLOptionElement 的定义 |
已过时 | 初始定义 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 支持 | 12 | 支持 | 支持 | 支持 | 支持 |
defaultSelected | 支持 | 12 | 支持 | 支持 | 支持 | 支持 |
disabled | 支持 | 12 | 支持 | 支持 | 支持 | 支持 |
form | 支持 | 12 | 支持 | 支持 | 支持 | 支持 |
index | 支持 | 12 | 支持 | 支持 | 支持 | 支持 |
label | 支持 | 12 | 7 支持 — 71 | 支持 | 支持 | 支持 |
selected | 支持 | 12 | 支持 | 支持 | 支持 | 支持 |
text | 支持 | 12 | 支持 | 支持 | 支持 | 支持 |
value | 支持 | 12 | 支持 | 支持 | 支持 | 支持 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 支持 |
defaultSelected | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 支持 |
disabled | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 支持 |
form | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 支持 |
index | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 支持 |
label | 支持 | 支持 | 未知 | 7 支持 — 71 | 未知 | 支持 | 支持 |
selected | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 支持 |
text | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 支持 |
value | 支持 | 支持 | 未知 | 支持 | 未知 | 支持 | 支持 |
1. 在 Firefox 7 之前的版本中,如果未定义 label
属性,则会错误地返回一个空字符串,而不是返回元素的文本内容。
相关链接
- 实现此接口的 HTML 元素:
<option>
。