TextTrack.addCue()
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.
addCue()
は TextTrack
インターフェイスのメソッドで、新しいキューをキューのリストへ追加します。
構文
js
addCue(cue)
引数
cue
-
TextTrackCue
です。
メモ: TextTrackCue
インターフェイスは、 VTTCue
などの他のキューインターフェイスの親クラスとして使用される抽象的なクラスです。したがって、キューを追加する場合は TextTrackCue
を継承したキュー型のいずれかを使用することになります。
返値
undefined
です。
例外
InvalidStateError
DOMException
-
この
TextTrackList
のルールが、入力されるTextTrackCue
に適切なルールと一致しない場合に発生します。
例
以下の例では、 addCue()
を使用して、動画のテキストトラックに 2 つのキューを追加しています。
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?"));
仕様書
Specification |
---|
HTML Standard # dom-texttrack-addcue-dev |
ブラウザーの互換性
BCD tables only load in the browser