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
# htmltrackelement

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLTrackElement
cuechange event
default
kind
label
readyState
src
srclang
track

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
See implementation notes.
Has more compatibility info.

参见

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