CKTIS / HTML
oncuechange — gestire i cambiamenti dei cue attivi di una traccia di testo
L’attributo oncuechange specifica il codice da eseguire per gli eventi cuechange, quando i cue temporizzati di una traccia di testo diventano attivi o smettono di esserlo. Anche gli oggetti TextTrack dispongono di una proprietà JavaScript con lo stesso nome.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
oncuechange="JavaScript statements"
trackElement.oncuechange = handler;
textTrack.oncuechange = handler;oncuechange è un attributo globale di gestione dell’evento cuechange. Il suo valore contiene istruzioni JavaScript, non l’URL di un file. Un destinatario tipico è un elemento track all’interno di video o audio; la disponibilità globale non significa che il browser generi questo evento su ogni elemento.
L’evento indica che uno o più cue della traccia di testo sono diventati attivi o hanno smesso di esserlo. Il browser lo invia all’oggetto TextTrack e, se esiste, all’elemento track corrispondente. Non è una notifica del completamento del download di un file di sottotitoli.
In un gestore dell’elemento, leggi this.track.activeCues per ottenere i cue attualmente attivi; in un gestore TextTrack, usa this.activeCues. Considera il valore null, soprattutto quando mode è "disabled". La modalità "hidden" consente di seguire i cue attivi senza visualizzare i sottotitoli.
Assegnare una funzione a oncuechange sostituisce il gestore precedente di quella proprietà; addEventListener("cuechange", handler) registra gestori indipendenti. Una policy CSP può bloccare il codice negli attributi. L’esempio invia intenzionalmente un evento sintetico: verifica la gestione dell’attributo senza file multimediali, ma non attiva alcun cue della traccia.
Esempi
<!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>Risultato
cuechange: captions
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.