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
属性来监听这些事件
使用说明
轨道文本资源的加载
如果轨道的 mode
最初处于 disabled
状态,则不会加载描述文本轨道实际提示的 WebVTT 或 TTML 数据。如果您需要在设置 <track>
后对轨道进行任何处理,则应确保轨道的 mode
为 hidden
(如果您不希望它一开始就向用户呈现)或 showing
(最初显示轨道)。您之后可以根据需要更改模式。
规范
规范 |
---|
HTML 标准 # htmltrackelement |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。
另请参阅
- 实现此接口的 HTML 元素:
<track>
.