TextTrack: cuechange イベント

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

例

TextTrack 上で

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

track.addEventListener('cuechange', function () {
  let cues = track.activeCues;  // 現在のキューの配列
});

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

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

track 要素上で

基本となる TextTrack は、 track プロパティで識別されますが、現在表示されているキューが変更されるたびに cuechange イベントを受け取ります。これは、トラックがメディア要素に結び付けられていなくても発生します。

トラックがメディア要素に結び付けられている場合、 <track> 要素を <audio> または <video> 要素の子として使用すると、 cuechange イベントは HTMLTrackElement にも送信されます。

let textTrackElem = document.getElementById("texttrack");

textTrackElem.addEventListener("cuechange", (event) => {
  let cues = event.target.track.activeCues;
});

また、oncuechange イベントハンドラーを使用することもできます。

let textTrackElem = document.getElementById("texttrack");

textTrackElem.oncuechange = (event) => {
  let cues = event.target.track.activeCues;
});

仕様書

ブラウザーの互換性

関連情報

• WebVTT