Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

loading — rinviare il caricamento delle risorse

L’attributo loading indica se il caricamento di una risorsa può essere rinviato in base alla posizione dell’elemento rispetto all’area visibile della pagina. Accetta lazy o eager; se è omesso o il valore non è valido, si applica eager. Lo standard lo definisce per img, iframe, audio e video.

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

Sintassi

loading="eager" | loading="lazy"

loading è un attributo enumerato, non booleano né globale. Su img, iframe, audio e video, lazy rinvia il recupero finché non sono soddisfatte condizioni legate alla posizione. eager disattiva questo rinvio; non garantisce che il caricamento sia completato né che abbia priorità alta. Se l’attributo è omesso, è vuoto (loading="") o ha un valore non valido, come loading="false", si applica lo stato eager.

Con lazy, il browser può iniziare il recupero prima che l’elemento entri nell’area visibile. Il margine che attiva il caricamento dipende dall’implementazione: non presumere quindi una distanza o un tempo specifici. Se l’esecuzione degli script è disattivata, questo meccanismo non rinvia il caricamento, come misura contro il tracciamento dello scorrimento. Per usare l’attributo, tuttavia, non serve JavaScript.

Per i media, lazy ha la precedenza su preload: prima rinvia il recupero e, quando il caricamento riprende, continuano ad applicarsi le regole di preload. Rinvia anche l’avvio della riproduzione tramite autoplay e il recupero dell’immagine poster di un elemento video. Un elemento audio senza controls non viene visualizzato, quindi non può essere caricato in modo differito. La presenza di queste funzionalità nello standard non implica che siano supportate da tutti i browser.

La proprietà DOM element.loading riflette l’attributo e restituisce i valori noti; un valore non valido produce eager. Impostare lo stato su eager riprende il caricamento in sospeso. L’esempio mostra i valori della proprietà per le impostazioni valide lazy e eager. Dopo aver impostato loading="invalid", si limita a confrontare image.loading con il valore letterale dell’attributo restituito da image.getAttribute('loading'). Il risultato false indica che i due valori sono diversi; non conferma che la proprietà abbia restituito eager. L’esempio non misura quando viene recuperata l’immagine. Per riservare spazio nel layout, specifica width e height per le immagini.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Image loading attribute</title>
</head>
<body>
  <img id="sample" loading="lazy" width="80" height="40" alt="Blue rectangle" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='80' height='40'%3E%3Crect width='80' height='40' fill='blue'/%3E%3C/svg%3E">
  <pre id="result"></pre>
  <script>
    const image = document.getElementById('sample');
    const lazy = image.loading;
    image.setAttribute('loading', 'eager');
    const eager = image.loading;
    image.setAttribute('loading', 'invalid');
    const preservesInvalidToken = image.loading === image.getAttribute('loading');
    document.getElementById('result').textContent = [
      `Initial loading property: ${lazy}`,
      `After setting loading="eager": ${eager}`,
      `Invalid token preserved by the property: ${preservesInvalidToken}`
    ].join('\n');
  </script>
</body>
</html>

Risultato

Initial loading property: lazy
After setting loading="eager": eager
Invalid token preserved by the property: false

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