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.