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>。