HTML DOM
HTMLTrackElement 接口表示 DOM 中的 HTML track 元素。此元素可以作为 audio 或 video 的子元素,以指定包含隐藏式字幕或标题等信息的文本轨道使用。
实例属性
从其父接口 HTMLElement 继承属性。
-
HTMLTrackElement.kind
- : 反映
kindHTML 属性的字符串,指示如何使用文本轨道。可能的值有:subtitles、captions、descriptions、chapters或metadata。
- : 反映
-
HTMLTrackElement.src
- : 反映
srcHTML 属性的字符串,指示文本轨道数据的地址。
- : 反映
-
HTMLTrackElement.srclang
- : 反映
srclangHTML 属性的字符串,指示文本轨道数据的语言。
- : 反映
-
HTMLTrackElement.label
- : 反映
labelHTML 属性的字符串,指示轨道的用户可读的标题。
- : 反映
-
HTMLTrackElement.default
- : 反映
default属性的布尔值,如果用户的偏好没有指示另一个轨道更合适,则指示要启用该轨道。
- : 反映
-
HTMLTrackElement.readyState
-
: 返回
unsigned short显示轨道的准备状态:常量 值 描述 NONE0 表示尚未获得文本轨道的提示(cue)。 LOADING1 表示正在加载文本轨道,到目前为止还没有遇到致命错误。解析器可能湘轨道中添加更多 cue。 LOADED2 表示已加载文本轨道,没有出现致命错误。 ERROR3 表示文本轨道已启用,但当用户代理尝试获取它时,以某种方式失败了。部分或全部 cue 可能丢失,且无法获得。
-
-
HTMLTrackElement.track
- : 返回 TextTrack 是轨道元素的文本轨道数据。
实例方法
无特定方法;从其父接口 HTMLElement 继承方法。
事件
从其父接口 HTMLElement 继承事件。
使用 EventTarget/addEventListener 或为此接口的 oneventname 属性分配一个事件监听器来监听这些事件:
- HTMLTrackElement.cuechange_event
- : 当底层的 TextTrack 更改了当前呈现的 cue 时发送事件。此事件始终发送到
TextTrack,但如果与轨道关联,则也会发送到HTMLTrackElement。你可以使用oncuechange事件为此事件建立处理器。
- : 当底层的 TextTrack 更改了当前呈现的 cue 时发送事件。此事件始终发送到
使用说明
加载轨道的文本资源
如果轨道的 TextTrack.mode 最初处于 disabled 状态,则描述文本轨道实际 cue 的 WebVTT 或 TTML 数据不加载。如果你需要在设置 <track> 之后对轨道执行任何处理,你应该确保轨道的 mode 是 hidden(如果你不想让它呈现给用户)或 showing(初始时显示轨道)。你可以以后根据需要更改模式。
规范
浏览器兼容性
参见
- 实现此接口的 HTML 元素:track。
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
