TextTrackCueList

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

TextTrackCueList 接口属于 WebVTT API,是一个类数组对象,表示一个动态更新的 TextTrackCue 对象列表。

通过 TextTrack.cues 获取此类型的实例,以获取 TextTrack 对象中的所有 cue。此接口没有构造函数。

实例属性

TextTrackCueList.length 只读

一个 unsigned long,表示列表中的 cue 数量。

实例方法

TextTrackCueList.getCueById()

返回具有传入标识符的第一个 TextTrackCue 对象。

示例

HTMLMediaElement.textTracks 属性返回一个 TextTrackList 对象,其中列出了所有 TextTrack 对象,每个与媒体关联的文本轨道对应一个。然后,TextTrack.cues 属性返回一个包含该特定轨道 cue 的 TextTrackCueList

js
const video = document.getElementById("video");
video.onplay = () => {
  console.log(video.textTracks[0].cues);
};

规范

规范
HTML
# texttrackcuelist

浏览器兼容性