HTML Audio/Video DOM textTracks 属性

定义和用法

textTracks 属性返回 TextTrackList 对象。

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

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

实例

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

myVid=document.getElementById("video1");
alert(myVid.textTracks.length);

亲自试一试

浏览器支持

表中的数字注明了首个完全支持该属性的浏览器版本。

Chrome Edge Firefox Safari Opera
支持 10.0 33.0 6.0 支持

语法

audio|video.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