TextTrack: 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 Ereignis-Handler-Eigenschaft.

js
addEventListener("cuechange", (event) => {});

oncuechange = (event) => {};

Eventtyp

Ein generisches Event ohne zusätzliche Eigenschaften.

Beispiele

Sie können einen Listener für das cuechange-Ereignis auf einem TextTrack mithilfe der addEventListener()-Methode einrichten:

js
track.addEventListener("cuechange", () => {
  const cues = track.activeCues; // array of current cues
  // …
});

Oder Sie können die oncuechange Ereignis-Handler-Eigenschaft setzen:

js
track.oncuechange = (event) => {
  let cues = track.activeCues; // array of current cues
};

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch