TextTrack: cuechange イベント

cuechange イベントは、 TextTrack が現在表示しているキューが変更されたときに発生します。このイベントは、表示されているものがあれば、 TextTrack および HTMLTrackElement の両方に発生します。

構文

このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

js
addEventListener("cuechange", (event) => {});

oncuechange = (event) => {};

イベント型

一般的な Event で、追加のプロパティはありません。

例

cuechange イベントのリスナーを TextTrack に設定するには、 addEventListener() メソッドを使用します。

js
track.addEventListener("cuechange", () => {
  const cues = track.activeCues; // 現在のキューの配列
  // …
});

あるいは、 oncuechange イベントハンドラープロパティを設定しても構いません。

js
track.oncuechange = (event) => {
  let cues = track.activeCues; // 現在のキューの配列
};

仕様書

Specification
HTML Standard
# event-media-cuechange
HTML Standard
# handler-texttrack-oncuechange

ブラウザーの互換性

BCD tables only load in the browser

関連情報