HTMLTrackElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

HTMLTrackElement 接口表示 DOM 中的 HTML <track> 元素。此元素可以作为 <audio><video> 的子元素,以指定包含隐藏式字幕或标题等信息的文本轨道使用。

EventTarget Node Element HTMLElement HTMLTrackElement

实例属性

从其父接口 HTMLElement 继承属性。

HTMLTrackElement.kind

反映 kind HTML 属性的字符串,指示如何使用文本轨道。可能的值有:subtitlescaptionsdescriptionschaptersmetadata

HTMLTrackElement.src

反映 src HTML 属性的字符串,指示文本轨道数据的地址。

HTMLTrackElement.srclang

反映 srclang HTML 属性的字符串,指示文本轨道数据的语言。

HTMLTrackElement.label

反映 label HTML 属性的字符串,指示轨道的用户可读的标题。

HTMLTrackElement.default

反映 default 属性的布尔值,如果用户的偏好没有指示另一个轨道更合适,则指示要启用该轨道。

HTMLTrackElement.readyState 只读

返回 unsigned short 显示轨道的准备状态:

常量 描述
NONE 0 表示尚未获得文本轨道的提示(cue)。
LOADING 1 表示正在加载文本轨道,到目前为止还没有遇到致命错误。解析器可能湘轨道中添加更多 cue。
LOADED 2 表示已加载文本轨道,没有出现致命错误。
ERROR 3 表示文本轨道已启用,但当用户代理尝试获取它时,以某种方式失败了。部分或全部 cue 可能丢失,且无法获得。
HTMLTrackElement.track 只读

返回 TextTrack 是轨道元素的文本轨道数据。

实例方法

无特定方法;从其父接口 HTMLElement 继承方法。

事件

从其父接口 HTMLElement 继承事件。

使用 addEventListener() 或为此接口的 oneventname 属性分配一个事件监听器来监听这些事件:

cuechange

当底层的 TextTrack 更改了当前呈现的 cue 时发送事件。此事件始终发送到 TextTrack,但如果与轨道关联,则会发送到 HTMLTrackElement。你可以使用 oncuechange 事件为此事件建立处理器。

使用说明

加载轨道的文本资源

如果轨道的 mode 最初处于 disabled 状态,则描述文本轨道实际 cue 的 WebVTT 或 TTML 数据不加载。如果你需要在设置 <track> 之后对轨道执行任何处理,你应该确保轨道的 modehidden(如果你不想让它呈现给用户)或 showing(初始时显示轨道)。你可以以后根据需要更改模式。

规范

Specification
HTML Standard
# htmltrackelement

浏览器兼容性

BCD tables only load in the browser

参见

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