CKTIS / HTML
onemptied — gestire lo svuotamento di una risorsa multimediale
L’attributo onemptied specifica il codice JavaScript da eseguire quando si verifica un evento emptied. Per audio e video, questo evento riguarda il ripristino dello stato della risorsa multimediale, non la normale conclusione della riproduzione.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
onemptied="JavaScript statements"onemptied è un attributo di contenuto HTML per la gestione dell’evento emptied. Il suo valore contiene istruzioni JavaScript; all’interno del gestore, l’oggetto evento è disponibile come event. È un attributo globale per la gestione degli eventi, ma gli elementi audio e video sono le fonti naturali di questo evento.
Il browser attiva emptied quando lo stato della risorsa multimediale viene ripristinato. Per esempio, load() accoda questo evento se il networkState precedente non era NETWORK_EMPTY. Chiamare load() su un elemento nuovo e vuoto, quindi, non garantisce che si verifichi un evento. Non confondere emptied con ended, che indica il raggiungimento della fine della riproduzione, né con la temporanea mancanza di dati per proseguirla.
In JavaScript, al posto dell’attributo, puoi assegnare una funzione a media.onemptied oppure usare media.addEventListener('emptied', handler). Il nome dell’evento non ha il prefisso on. Una nuova assegnazione alla proprietà sostituisce il gestore precedente; addEventListener permette di registrare gestori indipendenti. Una policy CSP può bloccare il codice negli attributi di gestione degli eventi.
L’esempio attiva intenzionalmente un evento emptied sintetico, quindi non richiede né un file multimediale né l’accesso alla rete. Il risultato visibile previsto è emptied. Questo verifica il collegamento del gestore, non un effettivo ripristino della risorsa; attivare l’evento non modifica lo stato del media.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>onemptied</title>
<audio onemptied="document.getElementById('result').textContent = event.type;"></audio>
<output id="result">pending</output>
<script>
const media = document.querySelector('audio');
media.dispatchEvent(new Event('emptied'));
</script>Risultato
emptied
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.