CKTIS / HTML
onloadeddata — gestire i dati multimediali disponibili
L’attributo onloadeddata esegue del codice quando si verifica l’evento loadeddata, non appena sono disponibili per la prima volta i dati relativi alla posizione di riproduzione corrente di audio o video. Non significa che l’intero file sia stato scaricato o che la riproduzione sia iniziata.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<video onloadeddata="handleData(event)"></video>
<audio onloadeddata="handleData(event)"></audio>
media.onloadeddata = handleData;onloadeddata è un attributo HTML per la gestione dell’evento loadeddata. È disponibile sugli elementi HTML, ma si usa soprattutto con audio e video. Il suo valore è codice JavaScript, non un valore booleano.
Il browser attiva loadeddata quando, durante il caricamento, può visualizzare per la prima volta i dati nella posizione di riproduzione corrente: readyState raggiunge HAVE_CURRENT_DATA (2) o uno stato superiore. Per un video, significa che è disponibile il fotogramma corrente, non l’intero filmato. loadedmetadata riguarda i metadati, mentre canplay indica che la riproduzione può proseguire almeno un po’. loadeddata da solo non avvia la riproduzione.
In JavaScript, assegna una funzione a media.onloadeddata; un’assegnazione successiva sostituisce il gestore precedente in quello slot. In alternativa, usa media.addEventListener('loadeddata', handler). Il nome dell’evento non ha il prefisso on. La Content Security Policy può bloccare i gestori scritti direttamente negli attributi.
L’esempio attiva deliberatamente un evento sintetico. Verifica il collegamento tra attributo e gestore e l’aggiornamento del testo, ma non verifica la decodifica o la disponibilità dei contenuti multimediali.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadeddata demo</title>
<audio id="media" onloadeddata="document.getElementById('result').textContent = event.type"></audio>
<p id="result">waiting</p>
<script>
// Synthetic event: tests the handler, not media loading.
document.getElementById('media').dispatchEvent(new Event('loadeddata'));
</script>
</html>Risultato
loadeddata
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.