TextTrack: removeCue() 方法

基线 广泛可用

此功能已经成熟,并在许多设备和浏览器版本上都能正常运行。它自 2015 年 7 月.

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

语法

js
removeCue(cue)

参数

cue

一个 TextTrackCue

返回值

未定义。

异常

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

浏览器兼容性

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