CKTIS / HTML
oncuechange — wijzigingen in actieve teksttrack-cues afhandelen
Het oncuechange-attribuut geeft aan welke code wordt uitgevoerd bij cuechange-gebeurtenissen wanneer getimede teksttrack-cues actief worden of niet langer actief zijn. TextTrack-objecten hebben ook een JavaScript-eigenschap met dezelfde naam.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
oncuechange="JavaScript statements"
trackElement.oncuechange = handler;
textTrack.oncuechange = handler;oncuechange is een globaal eventhandlerattribuut voor cuechange. De waarde bevat JavaScript-instructies, geen bestands-URL. Een gebruikelijk doel is een track-element binnen video of audio; de globale beschikbaarheid betekent niet dat de browser deze gebeurtenis op elk element genereert.
De gebeurtenis geeft aan dat een of meer teksttrack-cues actief zijn geworden of niet langer actief zijn. De browser verstuurt deze naar het TextTrack-object en, als dat bestaat, het bijbehorende track-element. Het is geen melding dat het downloaden van een ondertitelbestand is voltooid.
Lees in een elementhandler this.track.activeCues om de momenteel actieve cues op te halen; gebruik in een TextTrack-handler this.activeCues. Houd rekening met de waarde null, vooral wanneer mode "disabled" is. Met de modus "hidden" kun je actieve cues volgen zonder ondertitels weer te geven.
Als je een functie aan oncuechange toewijst, vervangt deze de vorige handler voor die eigenschap; addEventListener("cuechange", handler) registreert onafhankelijke listeners. Een CSP-beleid kan code in attributen blokkeren. Het voorbeeld verstuurt bewust een synthetische gebeurtenis: het controleert de attribuutafhandeling zonder mediabestanden, maar activeert geen track-cues.
Voorbeelden
<!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>Resultaat
cuechange: captions
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.