HTMLTrackElement: cuechange Ereignis
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2019.
Das cuechange-Ereignis wird ausgelöst, wenn ein TextTrack die aktuell angezeigten Cues geändert hat. Das Ereignis wird sowohl auf dem TextTrack als auch auf dem HTMLTrackElement ausgelöst, in dem es angezeigt wird, falls vorhanden.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("cuechange", (event) => { })
oncuechange = (event) => { }
Ereignistyp
Ein generisches Event ohne zusätzliche Eigenschaften.
Beispiele
das zugrunde liegende TextTrack, durch die track-Eigenschaft angezeigt, erhält jedes Mal ein cuechange-Ereignis, wenn der aktuell präsentierte Cue geändert wird. Dies geschieht auch, wenn das Track nicht mit einem Medien-Element verknüpft ist.
Wenn das Track mit einem Medien-Element verknüpft ist, indem das <track>-Element als Kind des <audio>- oder <video>-Elements verwendet wird, wird das cuechange-Ereignis auch an das HTMLTrackElement gesendet.
let textTrackElem = document.getElementById("text-track");
textTrackElem.addEventListener("cuechange", (event) => {
let cues = event.target.track.activeCues;
});
Alternativ können Sie den oncuechange-Ereignis-Handler verwenden:
let textTrackElem = document.getElementById("text-track");
textTrackElem.oncuechange = (event) => {
let cues = event.target.track.activeCues;
};
Spezifikationen
| Specification |
|---|
| HTML # event-media-cuechange |
| HTML # handler-oncuechange |