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

瀏覽器相容性