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