TextTrack: 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 2015 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 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
Sie können einen Listener für das cuechange-Ereignis auf einem TextTrack mithilfe der addEventListener()-Methode einrichten:
track.addEventListener("cuechange", () => {
const cues = track.activeCues; // array of current cues
// …
});
Oder Sie können die oncuechange-Ereignishandler-Eigenschaft setzen:
track.oncuechange = (event) => {
let cues = track.activeCues; // array of current cues
};
Spezifikationen
| Spezifikation |
|---|
| HTML # event-media-cuechange |
| HTML # handler-texttrack-oncuechange |
Browser-Kompatibilität
Siehe auch
- WebVTT
- Dasselbe Ereignis auf
HTMLTrackElement:cuechange