Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

preload — indicazione di precaricamento dei contenuti multimediali

L’attributo preload degli elementi audio e video indica al browser quanti dati multimediali potrebbe essere utile recuperare in anticipo. I valori none, metadata e auto sono indicazioni, non garanzie.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

preload="none|metadata|auto"

preload è un attributo enumerato di audio e video, non un attributo booleano. Suggerisce una strategia di buffering per la risorsa multimediale.

none suggerisce di evitare il recupero anticipato; non vieta di recuperare la risorsa quando inizia la riproduzione. metadata suggerisce di recuperare i metadati, come durata e dimensioni, eventualmente anche i fotogrammi iniziali; durante la riproduzione segnala una larghezza di banda limitata. auto consente di scaricare anche l’intera risorsa, ma non lo impone.

Un valore vuoto significa auto. Se l’attributo è assente o ha un valore non valido, il comportamento predefinito dipende dall’implementazione; lo standard suggerisce metadata.

Il browser può ignorare l’indicazione. autoplay può prevalere su di essa e, con gli script attivi, loading="lazy" può ritardarne l’applicazione. La proprietà DOM preload riflette l’attributo e consente di modificare l’indicazione anche durante il buffering o la riproduzione.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>preload</title>
<audio id="media" preload="none"></audio>
<pre id="result"></pre>
<script>
  const media = document.getElementById('media');
  const values = [media.preload];
  media.preload = 'metadata';
  values.push(media.preload);
  media.preload = 'auto';
  values.push(media.preload);
  document.getElementById('result').textContent = values.join('\n');
</script>

Risultato

none
metadata
auto

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