CKTIS / HTML
onwaiting — gestire l’attesa dei dati multimediali
L’attributo onwaiting specifica il codice da eseguire per l’evento waiting. Negli elementi audio e video, questo evento segnala che la riproduzione non può continuare perché non sono disponibili dati sufficienti. L’attributo, da solo, non avvia né il download né la riproduzione.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };onwaiting è l’attributo gestore dell’evento waiting. Il suo valore HTML è codice JavaScript, non un valore booleano. È disponibile su tutti gli elementi HTML, ma viene usato soprattutto con gli elementi audio e video. Il suo corrispondente JavaScript è la proprietà onwaiting.
L’evento waiting indica che la riproduzione non può continuare perché i dati necessari per il passaggio successivo non sono disponibili. Può verificarsi quando si avvia la riproduzione o quando il buffer si esaurisce. Da solo, non indica né un errore permanente né una perdita della connessione di rete. Non va confuso con stalled, che riguarda la mancata ricezione di dati mentre il browser tenta di recuperarli.
Un gestore può mostrare un indicatore di attesa; l’evento playing permette di reagire quando la riproduzione inizia o riprende. Un evento waiting naturale non si propaga e non può essere annullato, quindi return false non riprenderà la riproduzione. Assegnare una funzione a media.onwaiting sostituisce il gestore precedente di quella proprietà; addEventListener('waiting', handler) consente di registrare listener indipendenti.
L’esempio invia intenzionalmente un evento sintetico, così il risultato non dipende da un file multimediale o dalla rete. Il paragrafo dovrebbe passare da idle a waiting. Il test verifica solo il collegamento del gestore: non provoca un buffering reale né modifica lo stato della riproduzione. Le norme di sicurezza della pagina potrebbero bloccare gli script e i gestori di eventi inline.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>onwaiting demo</title>
<video id="media" onwaiting="document.getElementById('status').textContent = event.type"></video>
<p id="status">idle</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('waiting'));
</script>Risultato
waiting
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.