HTMLTrackElement: 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
で、追加のプロパティはありません。
例
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;
};
仕様書
Specification |
---|
HTML Standard # event-media-cuechange |
HTML Standard # handler-oncuechange |
ブラウザーの互換性
BCD tables only load in the browser