TextTrack: cuechange イベント

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.

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

関連情報