HTMLTrackElement: cuechange イベント
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2019年7月以降、すべてのブラウザーで利用可能です。
cuechange イベントは TextTrack が現在表示しているキューを変更した際に発生します。このイベントは TextTrack と、それが表示されている HTMLTrackElement があれば、その両方で発生します。
構文
このイベント名を addEventListener() などのメソッドで使用したり、イベントハンドラープロパティを設定したりしてください。
js
addEventListener("cuechange", (event) => {});
oncuechange = (event) => {};
イベント型
一般的な Event で、追加のプロパティはありません。
例
track プロパティで示される基礎となる TextTrack は、現在表示されているキューが変更される度に cuechange イベントを受信します。これは、そのトラックがメディア要素に関連付けられていない場合でも発生します。
そのトラックがメディア要素に関連付けられている場合、 <track> を <audio> または <video> 要素の子として使用すると、 cuechange イベントは HTMLTrackElement にも送信されます。
js
let textTrackElem = document.getElementById("texttrack");
textTrackElem.addEventListener("cuechange", (event) => {
let cues = event.target.track.activeCues;
});
あるいは、 oncuechange イベントハンドラーを使用することもできます。
js
let textTrackElem = document.getElementById("texttrack");
textTrackElem.oncuechange = (event) => {
let cues = event.target.track.activeCues;
};
仕様書
| 仕様書 |
|---|
| HTML # event-media-cuechange |
| HTML # handler-oncuechange |