TextTrack.removeCue()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
removeCue()
は TextTrack
インターフェイスのメソッドで、キューのリストからキューを取り除きます。
構文
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);
仕様書
Specification |
---|
HTML Standard # dom-texttrack-removecue-dev |
ブラウザーの互換性
BCD tables only load in the browser