Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti