TextTrack: addCue() 方法

基线 广泛可用

此功能已得到良好建立，并且可在许多设备和浏览器版本上运行。它自以下时间起在所有浏览器中均可用 2015 年 7 月.

addCue() 方法是 TextTrack 接口的方法，用于向提示列表中添加新的提示。

语法

js
addCue(cue)

参数

cue

一个 TextTrackCue。

注意：TextTrackCue 接口是一个抽象类，用作其他提示接口（如 VTTCue）的父类。因此，在添加提示时，您将使用从 TextTrackCue 继承的提示类型之一。

返回值

未定义。

异常

InvalidStateError DOMException

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

示例

在以下示例中，使用 addCue() 将两个提示添加到视频文本轨道。

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

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。