TextTrack.addCue()

addCue() は TextTrack インターフェイスのメソッドで、新しいキューをキューのリストへ追加します。

構文

js

addCue(cue)

引数

cue

TextTrackCue です。

メモ: TextTrackCue インターフェイスは、 VTTCue などの他のキューインターフェイスの親クラスとして使用される抽象的なクラスです。したがって、キューを追加する場合は TextTrackCue を継承したキュー型のいずれかを使用することになります。

返値

undefined です。

例外

InvalidStateError DOMException

この TextTrackList (en-US) のルールが、入力される 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