CKTIS / HTML
onloadedmetadata — gestire il caricamento dei metadati multimediali
L’attributo onloadedmetadata contiene JavaScript che gestisce l’evento loadedmetadata, di solito su audio o video. Indica che i metadati sono disponibili, non che il download sia terminato o che la riproduzione possa proseguire senza interruzioni.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
onloadedmetadata="JavaScript statements"onloadedmetadata è un attributo HTML per la gestione dell’evento loadedmetadata. Il suo valore è codice JavaScript, non il nome di un evento né un valore booleano. È consentito sugli elementi HTML, ma si usa tipicamente con audio e video.
Il browser genera loadedmetadata quando i metadati della risorsa in caricamento diventano disponibili per la prima volta: readyState raggiunge almeno HAVE_METADATA. A quel punto si possono leggere duration e, per i video, videoWidth e videoHeight. La durata può essere Infinity se la risorsa non ha una fine nota. Questo non significa che l’intero file sia stato scaricato; loadeddata riguarda la disponibilità dei dati del fotogramma corrente.
Nel codice dell’attributo, event indica l’evento e this l’elemento. In JavaScript, si può invece assegnare una funzione a media.onloadedmetadata oppure usare media.addEventListener('loadedmetadata', handler). Il nome dell’evento non ha il prefisso on. L’assegnazione alla proprietà sostituisce la funzione precedente; addEventListener consente gestori indipendenti. Una policy CSP può bloccare il codice negli attributi.
L’esempio genera intenzionalmente un evento sintetico per provare l’attributo senza un file multimediale. Non carica metadati e non modifica readyState. Per il caricamento effettivo di contenuti multimediali, registra il gestore prima di iniziare a recuperare la risorsa.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onloadedmetadata demo</title>
<audio id="media" onloadedmetadata="document.getElementById('result').textContent = event.type + ' handled'"></audio>
<p id="result">Waiting</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('loadedmetadata'));
</script>
</html>Risultato
loadedmetadata handled
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.