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.

js
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.

js
let textTrackElem = document.getElementById("text-track");

textTrackElem.addEventListener("cuechange", (event) => {
  let cues = event.target.track.activeCues;
});

Alternativ können Sie den oncuechange Ereignishandler verwenden:

js
let textTrackElem = document.getElementById("text-track");

textTrackElem.oncuechange = (event) => {
  let cues = event.target.track.activeCues;
};

Spezifikationen

Specification
HTML
# event-media-cuechange
HTML
# handler-oncuechange

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
cuechange event

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.

Siehe auch