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