CKTIS / HTML
onprogress — gestire gli eventi di avanzamento del download
L’attributo onprogress contiene codice JavaScript che gestisce l’evento progress. Per gli elementi audio e video riguarda il download dei dati multimediali, non il tempo di riproduzione trascorso.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
onprogress="JavaScript statements"
element.onprogress = handler;
element.addEventListener("progress", handler);onprogress è un attributo gestore dell’evento progress. È disponibile su tutti gli elementi HTML, ma la sua sola presenza non avvia download né genera eventi. La proprietà JavaScript corrispondente è disponibile anche sugli oggetti Document e Window.
Per audio e video, progress segnala il download dei dati multimediali. Non indica l’avanzamento della riproduzione e non fornisce automaticamente una percentuale dei byte scaricati. L’evento multimediale usa l’interfaccia Event, non ProgressEvent; non presumere che loaded e total siano disponibili.
Il valore dell’attributo è codice JavaScript, in cui event si riferisce all’evento. In alternativa, assegna una funzione a element.onprogress oppure usa element.addEventListener("progress", handler). L’assegnazione alla proprietà sostituisce il gestore precedente di quel meccanismo; addEventListener() consente di registrare listener indipendenti.
L’esempio invia esplicitamente un evento progress sintetico, quindi il risultato non dipende dalla rete. Verifica la gestione dell’attributo, non l’effettivo avanzamento di un download. La Content Security Policy può bloccare i gestori di eventi e gli script inline.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onprogress demo</title>
<body>
<audio id="media" onprogress="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
document.getElementById('media').dispatchEvent(new Event('progress'));
</script>
</body>
</html>Risultato
progress
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.