HTMLTrackElement

基线 广泛可用

此功能已完善,可在许多设备和浏览器版本上运行。它自 2015 年 7 月.

HTMLTrackElement 接口表示 HTML <track> 元素在 DOM 中。此元素可以用作 <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 表示文本轨道的提示尚未获取。
LOADING 1 表示文本轨道正在加载,并且迄今尚未遇到致命错误。解析器可能仍会将更多提示添加到轨道中。
LOADED 2 表示文本轨道已加载,没有致命错误。
ERROR 3 表示文本轨道已启用,但当用户代理尝试获取它时,以某种方式失败了。一些或所有提示可能丢失,将无法获取。
HTMLTrackElement.track 只读

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

实例方法

没有特定方法;从其父级 HTMLElement 继承方法。

事件

从其父级 HTMLElement 继承事件。

使用 addEventListener() 监听这些事件,或者通过将事件侦听器分配给此接口的 oneventname 属性来监听这些事件

cuechange

当底层 TextTrack 更改了当前呈现的提示时发送。此事件始终发送到 TextTrack,但如果与轨道关联,则还会发送到 HTMLTrackElement。您也可以使用 oncuechange 事件处理程序为该事件建立处理程序。

使用说明

轨道文本资源的加载

如果轨道的 mode 最初处于 disabled 状态,则不会加载描述文本轨道实际提示的 WebVTT 或 TTML 数据。如果您需要在设置 <track> 后对轨道进行任何处理,则应确保轨道的 modehidden(如果您不希望它一开始就向用户呈现)或 showing(最初显示轨道)。您之后可以根据需要更改模式。

规范

规范
HTML 标准
# htmltrackelement

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅

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