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