TextTrack: cuechange イベント
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。
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; // 現在のキューの配列
};
仕様書
| 仕様書 |
|---|
| HTML # event-media-cuechange |
| HTML # handler-texttrack-oncuechange |
ブラウザーの互換性
関連情報
- WebVTT
HTMLTrackElementにおける同一のイベント:cuechange