Video textTracks 属性

Video textTracks 属性 Video 对象实例获得可用文本轨道的数量： var x = document.getElementById('myVideo').textTracks.length; 尝试一下 » 定义和用法 textTracks 属性返回 TextTrackList 对象。 TextTrackList 对象表示音频/视频的可用文本轨道。每条可用的文本轨道是由 Te..

更新于 2026/7/16

教程详情页默认 noindex。

Video textTracks 属性

Video 对象参考手册 Video 对象

实例

获得可用文本轨道的数量：

var x = document.getElementById("myVideo").textTracks.length;

尝试一下 »

定义和用法

textTracks 属性返回 TextTrackList 对象。

TextTrackList 对象表示音频/视频的可用文本轨道。

每条可用的文本轨道是由 TextTrack 对象表示的。

浏览器支持

Internet Explorer, Opera, Chrome, 和 Safari 6 浏览器支持 textTracks 属性。

注意：Firefox 和 Internet Explorer 9 及更早 IE 版本不支持 textTracks 属性。

语法

videoObject.textTracks

返回值

类型	描述
TextTrackList 对象	表示音频/视频的可用文本轨道。 TextioTrackList 对象的属性： length - 获得音频/视频中可用的文本轨道的数量 [index] - 根据下标来获得 TextTrack 对象注释：第一条可用文本轨道的下标是 0。
TextTrack 对象	表示一条文本轨道。 TextTrack 对象的属性： kind - 获得文本轨道的类型（可以是 "subtitles", "caption", "descriptions", "chapters" 或者 "metadata") label - 获得文本轨道的标签 language - 获得文本轨道的语言 mode - 获得或设置该轨道是否是活动的 ("disabled"\|"hidden"\|"showing") cues - 获得 TextTrackCueList 对象的 cues 列表 activeCues - 获得 TextTrackCueList 对象形式的当前活动文本轨道 cues addCue(cue) - 向 cues 列表添加一个 cue removeCue(cue) - 从 cues 列表删除一个 cue

类型

描述

TextTrackList 对象

表示音频/视频的可用文本轨道。

TextioTrackList 对象的属性：

length - 获得音频/视频中可用的文本轨道的数量
[index] - 根据下标来获得 TextTrack 对象

注释：第一条可用文本轨道的下标是 0。

TextTrack 对象

表示一条文本轨道。

TextTrack 对象的属性：

kind - 获得文本轨道的类型（可以是 "subtitles", "caption", "descriptions", "chapters" 或者 "metadata")
label - 获得文本轨道的标签
language - 获得文本轨道的语言
mode - 获得或设置该轨道是否是活动的 ("disabled"|"hidden"|"showing")
cues - 获得 TextTrackCueList 对象的 cues 列表
activeCues - 获得 TextTrackCueList 对象形式的当前活动文本轨道 cues
addCue(cue) - 向 cues 列表添加一个 cue
removeCue(cue) - 从 cues 列表删除一个 cue

Video 对象