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>
的子元素,以指定包含隐藏式字幕或标题等信息的文本轨道使用。
实例属性
从其父接口 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 表示尚未获得文本轨道的提示(cue)。 LOADING
1 表示正在加载文本轨道,到目前为止还没有遇到致命错误。解析器可能湘轨道中添加更多 cue。 LOADED
2 表示已加载文本轨道,没有出现致命错误。 ERROR
3 表示文本轨道已启用,但当用户代理尝试获取它时,以某种方式失败了。部分或全部 cue 可能丢失,且无法获得。 HTMLTrackElement.track
只读-
返回
TextTrack
是轨道元素的文本轨道数据。
实例方法
无特定方法;从其父接口 HTMLElement
继承方法。
事件
从其父接口 HTMLElement
继承事件。
使用 addEventListener()
或为此接口的 oneventname
属性分配一个事件监听器来监听这些事件:
使用说明
加载轨道的文本资源
如果轨道的 mode
最初处于 disabled
状态,则描述文本轨道实际 cue 的 WebVTT 或 TTML 数据不加载。如果你需要在设置 <track>
之后对轨道执行任何处理,你应该确保轨道的 mode
是 hidden
(如果你不想让它呈现给用户)或 showing
(初始时显示轨道)。你可以以后根据需要更改模式。
规范
Specification |
---|
HTML Standard # htmltrackelement |
浏览器兼容性
BCD tables only load in the browser
参见
- 实现此接口的 HTML 元素:
<track>
。