HTMLTrackElement: cuechange-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2019 browserübergreifend verfügbar.
Das cuechange-Ereignis wird ausgelöst, wenn sich die aktuell angezeigten Cues eines TextTrack ändern. Das Ereignis wird sowohl auf dem TextTrack als auch auf dem HTMLTrackElement ausgelöst, in dem er gegebenenfalls dargestellt wird.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("cuechange", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
oncuechange = (event) => { }
Ereignistyp
Ein generisches Event ohne zusätzliche Eigenschaften.
Beispiele
Der zugrunde liegende TextTrack, auf den die Eigenschaft track verweist, empfängt jedes Mal ein cuechange-Ereignis, wenn sich der aktuell angezeigte Cue ändert. Dies geschieht auch dann, wenn der Track keinem Medienelement zugeordnet ist.
Wenn der Track einem Medienelement zugeordnet ist, indem das <track>-Element als Kindelement 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-Event-Handler verwenden. Beachten Sie jedoch, dass dadurch andere gegebenenfalls über oncuechange hinzugefügte Event-Listener ersetzt werden:
let textTrackElem = document.getElementById("text-track");
textTrackElem.oncuechange = (event) => {
let cues = event.target.track.activeCues;
};
Spezifikationen
| Spezifikation |
|---|
| HTML # event-media-cuechange |
| HTML # handler-oncuechange |