HTMLTrackElement - 表示 <track> 元素

HTMLTrackElement 接口提供了特殊的属性(除了通过继承通用的 HTMLElement 接口获得的常规属性)来操作 <track> 元素。

属性

从其父接口 HTMLElement 继承了属性。

HTMLTrackElement.kind

一个 DOMString,它反映了 kind HTML 属性,指示了如何使用文本轨道。可能的值包括:subtitlescaptionsdescriptionschaptersmetadata

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 的定义
推荐 初始定义。

桌面浏览器兼容性

特性ChromeEdgeFirefoxInternet ExplorerOperaSafari
基础支持23 支持

311

24 — 30

不支持12 支持
default23 支持

31

24 — 30

不支持12 支持
kind23 支持

31

24 — 30

不支持12 支持
label23 支持

31

24 — 30

不支持12 支持
readyState23 支持

31

24 — 30

不支持12 支持
src23 支持

312

24 — 30

不支持12 支持
srclang23 支持

31

24 — 30

不支持12 支持
track23 支持

31

24 — 30

不支持12 支持

移动浏览器兼容性

特性AndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
基础支持2323 支持

311

24 — 30

未知12 支持
default2323 支持

31

24 — 30

未知12 支持
kind2323 支持

31

24 — 30

未知12 支持
label2323 支持

31

24 — 30

未知12 支持
readyState2323 支持

31

24 — 30

未知12 支持
src2323 支持

312

24 — 30

未知12 支持
srclang2323 支持

31

24 — 30

未知12 支持
track2323 支持

31

24 — 30

未知12 支持

1. 在 Firefox 50 之前,只有 <track> 元素在文档中时才会加载文本轨道。

2. 在 Firefox 50 之前的版本中,设置 src 属性无法正常工作。

相关链接

  • 实现该接口的 HTML 元素:<track>