CKTIS / HTML
oncuechange — Änderungen aktiver Texttrack-Cues behandeln
Das Attribut oncuechange legt fest, welcher Code bei cuechange-Ereignissen ausgeführt wird, wenn zeitgesteuerte Texttrack-Cues aktiv werden oder nicht mehr aktiv sind. Eine JavaScript-Eigenschaft gleichen Namens ist auch für TextTrack-Objekte verfügbar.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oncuechange="JavaScript statements"
trackElement.oncuechange = handler;
textTrack.oncuechange = handler;oncuechange ist ein globales Event-Handler-Attribut für cuechange. Sein Wert enthält JavaScript-Anweisungen und keine Datei-URL. Ein typisches Ziel ist ein track-Element innerhalb von video oder audio; die globale Verfügbarkeit bedeutet nicht, dass der Browser dieses Ereignis auf jedem Element auslöst.
Das Ereignis zeigt an, dass mindestens ein Texttrack-Cue aktiv geworden ist oder nicht mehr aktiv ist. Der Browser löst es für das TextTrack-Objekt und, falls vorhanden, für das zugehörige track-Element aus. Es ist keine Benachrichtigung darüber, dass der Download einer Untertiteldatei abgeschlossen ist.
Lies in einem Element-Handler this.track.activeCues, um die derzeit aktiven Cues zu erhalten; in einem TextTrack-Handler verwendest du this.activeCues. Berücksichtige den Wert null, besonders wenn mode den Wert "disabled" hat. Im Modus "hidden" lassen sich aktive Cues verfolgen, ohne Untertitel anzuzeigen.
Wenn du der Eigenschaft oncuechange eine Funktion zuweist, ersetzt sie den vorherigen Handler dieser Eigenschaft; addEventListener("cuechange", handler) registriert unabhängige Listener. Eine CSP-Richtlinie kann Code in Attributen blockieren. Das Beispiel löst absichtlich ein synthetisches Ereignis aus: Es prüft die Verarbeitung des Attributs ohne Mediendateien, aktiviert aber keine Track-Cues.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>oncuechange</title>
<video>
<track id="captions" kind="captions" srclang="en" src="data:text/vtt,WEBVTT%0A%0A"
oncuechange="document.getElementById('result').textContent = event.type + ': ' + this.kind">
</video>
<output id="result"></output>
<script>
const trackElement = document.getElementById('captions');
trackElement.dispatchEvent(new Event('cuechange'));
</script>Ergebnis
cuechange: captions
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.