TextTrack: removeCue() method

Baseline 已广泛支持

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

removeCue()TextTrack 接口的一个方法,用于从提示列表(list of cues)中删除一个提示。

语法

js
removeCue(cue)

参数

cue

一个 TextTrackCue

返回值

Undefined。

异常

NotFoundError DOMException

如果给定的提示在提示列表中找不到,则抛出此异常。

注意: TextTrackCue 接口是一个抽象类,用作其他提示接口(例如 VTTCue)的父类。因此,在删除提示时,您将传入继承自 TextTrackCue 的其中一种提示类型。

示例

在下面的示例中,使用 addCue() 将提示添加到视频文本轨道中,然后使用 removeCue 将其删除。

js
let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en");
track.mode = "showing";
let cue = new VTTCue(0, 0.9, "Hildy!");
track.addCue(cue);
track.removeCue(cue);

规范

规范
HTML
# dom-texttrack-removecue-dev

浏览器兼容性