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

関連情報