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 sich die aktuell angezeigten Cues eines TextTrack ändern. Das Ereignis wird sowohl auf dem TextTrack als auch auf dem HTMLTrackElement ausgelöst, in dem er dargestellt wird, sofern vorhanden.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("cuechange", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
oncuechange = (event) => { }
Ereignistyp
Ein generisches Event ohne zusätzliche Eigenschaften.
Beispiele
Mit der Methode addEventListener() können Sie einen Listener für das cuechange-Ereignis auf einem TextTrack einrichten:
track.addEventListener("cuechange", () => {
const cues = track.activeCues; // array of current cues
// …
});
Alternativ können Sie die Event-Handler-Eigenschaft oncuechange festlegen. Beachten Sie jedoch, dass dadurch gegebenenfalls andere über oncuechange hinzugefügte Event-Listener ersetzt werden:
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