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

In diesem Artikel

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

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

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

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

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

Spezifikationen

Spezifikation

HTML
# event-media-cuechange

HTML
# handler-oncuechange

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

WebVTT
Dasselbe Ereignis auf TextTrack: cuechange

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

WebVTT API
HTMLTrackElement
Instanzeigenschaften
Events
1. cuechange
Vererbung
Verwandte Seiten für WebVTT
Anleitungen
1. Web Video Text Tracks Format (WebVTT)