CKTIS / HTML
ondurationchange — gestire le variazioni della durata dei contenuti multimediali
L’attributo ondurationchange contiene codice JavaScript eseguito per l’evento durationchange. Di solito serve ad aggiornare le informazioni sulla durata negli elementi audio e video; non segnala l’avanzamento della riproduzione in corso.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
ondurationchange="JavaScript statements"ondurationchange è un attributo per la gestione dell’evento durationchange, usato in genere con gli elementi audio e video. Il suo valore è codice JavaScript, non un booleano né un valore di durata. Nel gestore definito nell’attributo, this fa riferimento all’elemento ed event fornisce l’oggetto evento.
Il browser genera questo evento quando cambia la durata stabilita della risorsa, per esempio quando diventa nota o viene aggiornata. Leggi this.duration: il risultato è espresso in secondi, NaN significa che non sono disponibili dati e Infinity indica una durata illimitata. Non è un evento relativo all’avanzamento della riproduzione; per quello usa timeupdate.
In JavaScript puoi invece assegnare una funzione a media.ondurationchange oppure usare media.addEventListener('durationchange', handler). Il nome dell’evento non ha il prefisso on. L’assegnazione alla proprietà sostituisce il gestore esistente in quello slot; addEventListener permette di aggiungere gestori indipendenti. Una policy CSP può bloccare il codice scritto direttamente nell’attributo.
L’esempio genera un evento sintetico senza recuperare contenuti multimediali. Verifica il collegamento tra attributo e gestore, non il rilevamento di un’effettiva variazione della durata. Non modifica duration, quindi il testo previsto è durationchange: NaN.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>ondurationchange</title>
<audio id="media" ondurationchange="document.getElementById('result').textContent = event.type + ': ' + String(this.duration)"></audio>
<output id="result"></output>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('durationchange'));
</script>Risultato
durationchange: NaN
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.