HTMLTrackElement - 表示 <track> 元素
HTMLTrackElement 接口提供了特殊的属性(除了通过继承通用的 HTMLElement 接口获得的常规属性)来操作 <track> 元素。
属性
从其父接口 HTMLElement 继承了属性。
HTMLTrackElement.kind
一个 DOMString,它反映了 kind HTML 属性,指示了如何使用文本轨道。可能的值包括:subtitles,captions,descriptions,chapters 和 metadata。
HTMLTrackElement.src
一个 DOMString,它反映了 src HTML 属性,表示文本轨道数据的地址。
HTMLTrackElement.srclang
一个 DOMString,它反映了 srclang HTML 属性,表示文本轨道数据的语言。
HTMLTrackElement.label
一个 DOMString,它反映了 label HTML 属性,表示该轨道的用户可读标题。
HTMLTrackElement.default
一个 Boolean,它反映了 default HTML 属性,表示默认启用该轨道。
HTMLTrackElement.readyState 只读
返回一个 unsigned short ,显示轨道的准备状态:
| 常量 | 值 | 描述 |
|---|---|---|
NONE |
0 | 表示尚未获得文本轨道的提示。Indicates that the text track's cues have not been obtained. |
LOADING |
1 | 表示文本轨道正在加载,并且到目前为止没有遇到致命错误。解析器可能仍会在轨道中添加其他提示。 |
LOADED |
2 | 表示文本轨道已加载且没有致命错误。 |
ERROR |
3 | 表示已启用文本轨道,但是当用户代理尝试获取该文本轨道时,它以某种方式失败。部分或全部提示可能已丢失,并且无法获得。 |
HTMLTrackElement.track 只读
返回 TextTrack,表示轨道元素的文本轨道数据。
方法
没有特有的方法;从其父接口 HTMLElement 继承了方法。
规范
| 规范 | 状态 | 备注 |
|---|---|---|
| HTML Living Standard HTMLTrackElement 的定义 |
现行的标准 | - |
| HTML5 HTMLTrackElement 的定义 |
推荐 | 初始定义。 |
桌面浏览器兼容性
| 特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基础支持 | 23 | 支持 | 311 24 — 30 | 不支持 | 12 | 支持 |
default | 23 | 支持 | 31 24 — 30 | 不支持 | 12 | 支持 |
kind | 23 | 支持 | 31 24 — 30 | 不支持 | 12 | 支持 |
label | 23 | 支持 | 31 24 — 30 | 不支持 | 12 | 支持 |
readyState | 23 | 支持 | 31 24 — 30 | 不支持 | 12 | 支持 |
src | 23 | 支持 | 312 24 — 30 | 不支持 | 12 | 支持 |
srclang | 23 | 支持 | 31 24 — 30 | 不支持 | 12 | 支持 |
track | 23 | 支持 | 31 24 — 30 | 不支持 | 12 | 支持 |
移动浏览器兼容性
| 特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| 基础支持 | 23 | 23 | 支持 | 311 24 — 30 | 未知 | 12 | 支持 |
default | 23 | 23 | 支持 | 31 24 — 30 | 未知 | 12 | 支持 |
kind | 23 | 23 | 支持 | 31 24 — 30 | 未知 | 12 | 支持 |
label | 23 | 23 | 支持 | 31 24 — 30 | 未知 | 12 | 支持 |
readyState | 23 | 23 | 支持 | 31 24 — 30 | 未知 | 12 | 支持 |
src | 23 | 23 | 支持 | 312 24 — 30 | 未知 | 12 | 支持 |
srclang | 23 | 23 | 支持 | 31 24 — 30 | 未知 | 12 | 支持 |
track | 23 | 23 | 支持 | 31 24 — 30 | 未知 | 12 | 支持 |
1. 在 Firefox 50 之前,只有 <track> 元素在文档中时才会加载文本轨道。
2. 在 Firefox 50 之前的版本中,设置 src 属性无法正常工作。
相关链接
- 实现该接口的 HTML 元素:
<track>。