HTML 音频/视频 DOM textTracks 属性

HTML audio/video 标签参考手册 HTML 音频/视频 DOM 参考手册

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

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
</head>
<body>

  <button onclick="getTextTracks()" type="button">获得可用文本轨道的数量</button>
  <br>
  <video id="video1" controls="controls">
  <source src="/examples/mov_bbb.mp4" type="video/mp4">
  <source src="/examples/mov_bbb.ogg" type="video/ogg">
  <track src="demo_sub.vtt">
  您的浏览器不支持 HTML5 video  标签。
</video>

  <script>
    myVid = document.getElementById("video1");

    function getTextTracks() {
      alert(myVid.textTracks.length);
    }
  </script>

  <p>Video courtesy of <a href="http://www.bigbuckbunny.org/" target="_blank">Big Buck Bunny</a>.</p>

</body>
</html>

尝试一下 »

定义和用法

textTracks 属性返回 TextTrackList 对象。

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

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

浏览器支持

Internet ExplorerFirefoxOperaGoogle ChromeSafari

Internet Explorer 10、Opera、Chrome 和 Safari 6 支持 textTracks 属性。

注意：Internet Explorer 9 及之前的版本不支持 textTracks 属性。

语法

audio|video.textTracks

返回值

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

TextioTrackList 对象：

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

注释：第一个可用文本轨道的下标 index 是 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
HTML audio/video 标签参考手册 HTML 音频/视频 DOM 参考手册