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

瀏覽器相容性