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 2015.
Das cuechange
-Ereignis wird ausgelöst, wenn ein TextTrack
die derzeit angezeigten Cues geändert hat. Das Ereignis wird sowohl auf dem TextTrack
als auch auf dem HTMLTrackElement
ausgelöst, in dem es präsentiert wird, falls vorhanden.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignishandler-Eigenschaft.
addEventListener("cuechange", (event) => {});
oncuechange = (event) => {};
Ereignistyp
Ein generisches Event
ohne zusätzliche Eigenschaften.
Beispiele
Der zugrundeliegende TextTrack
, angezeigt durch die track
Eigenschaft, erhält jedes Mal ein cuechange
-Ereignis, wenn der derzeit angezeigte Cue geändert wird. Dies geschieht, selbst wenn der Track nicht mit einem Medien-Element verbunden ist.
Wenn der Track mit einem Medien-Element verbunden ist, wobei das <track>
Element als Kind des <audio>
oder <video>
Elements genutzt 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
Ereignishandler verwenden:
let textTrackElem = document.getElementById("text-track");
textTrackElem.oncuechange = (event) => {
let cues = event.target.track.activeCues;
};
Spezifikationen
Specification |
---|
HTML Standard # event-media-cuechange |
HTML Standard # handler-oncuechange |
Browser-Kompatibilität
BCD tables only load in the browser