TextTrack: addCue() 方法

Baseline 已广泛支持

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

TextTrack 接口的 addCue() 方法将一个新的 cue(提示)添加到 cue 列表中。

语法

js
addCue(cue)

参数

cue

一个 TextTrackCue

注意: TextTrackCue 接口是一个抽象类,用作其他 cue 接口(如 VTTCue)的父类。因此,添加 cue 时,你将使用继承自 TextTrackCue 的其中一种 cue 类型。

返回值

Undefined。

异常

InvalidStateError DOMException

如果此 TextTrackList 的规则与传入的 TextTrackCue 不匹配,则抛出此异常。

示例

在下面的示例中,使用 addCue() 向视频文本轨道添加了两个 cue。

js
let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en");
track.mode = "showing";
track.addCue(new VTTCue(0, 0.9, "Hildy!"));
track.addCue(new VTTCue(1, 1.4, "How are you?"));

规范

规范
HTML
# dom-texttrack-addcue-dev

浏览器兼容性