このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
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 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;};仕様書
| Specification |
|---|
| HTML # event-media-cuechange |
| HTML # handler-oncuechange |