HTMLTrackElement

实例属性

继承自其父级 HTMLElement 的属性。

HTMLTrackElement.kind

一个字符串，反映了 kind HTML 属性，指示文本轨道的用途。可能的值包括：subtitles、captions、descriptions、chapters 或 metadata。

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 与该轨道相关联，也会发送到 HTMLTrackElement。您也可以使用 oncuechange 事件处理程序为该事件设置处理程序。

用法说明

加载轨道的文本资源

如果轨道的 mode 最初设置为 disabled 状态，那么描述文本轨道实际提示信息的 WebVTT 或 TTML 数据将不会被加载。如果您需要在设置 <track> 元素后对其执行任何处理，则应确保轨道的 mode 设置为 hidden（如果您不希望一开始就向用户显示该轨道）或 showing（以初始显示该轨道）。之后，您可以根据需要更改模式。

规范

浏览器兼容性

另见

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