Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

loading — odložení načítání zdrojů

Atribut loading určuje, zda lze načítání zdroje odložit podle polohy prvku vzhledem k viditelné oblasti stránky. Přijímá hodnoty lazy nebo eager; při vynechání atributu či neplatné hodnotě platí eager. Standard jej definuje pro img, iframe, audio a video.

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

Syntaxe

loading="eager" | loading="lazy"

loading je výčtový atribut, nikoli booleovský ani globální atribut. U prvků img, iframe, audio a video hodnota lazy odloží načtení, dokud nejsou splněny podmínky související s polohou. Hodnota eager toto odložení vypne; nezaručuje dokončení načítání ani vysokou prioritu. Pokud atribut chybí, je prázdný (loading="") nebo má neplatnou hodnotu, například loading="false", platí stav eager.

Při hodnotě lazy může prohlížeč začít načítat ještě před vstupem prvku do viditelné oblasti. Spouštěcí okraj závisí na implementaci, proto nepředpokládejte konkrétní vzdálenost ani čas. Když je vypnuté spouštění skriptů, tento mechanismus načítání neodkládá; jde o ochranu před sledováním posouvání stránky. K samotnému použití atributu však JavaScript potřeba není.

U médií má lazy přednost před preload: nejprve odloží načítání a po jeho obnovení se nadále uplatňují pravidla pro preload. Odkládá také zahájení přehrávání pomocí autoplay a načtení obrázku poster prvku video. Prvek audio bez atributu controls se nezobrazuje, takže jej nelze načítat líně. To, že jsou tyto funkce součástí standardu, neznamená, že je podporuje každý prohlížeč.

Vlastnost DOM element.loading odráží atribut a vrací známé hodnoty; neplatná hodnota odpovídá eager. Změna stavu na eager obnoví čekající načítání. Příklad vypíše hodnoty vlastnosti pro platná nastavení lazy a eager. Po nastavení loading="invalid" pouze porovná image.loading s původní hodnotou atributu, kterou vrací image.getAttribute('loading'). Výsledek false ukazuje, že se tyto dvě hodnoty liší; nepotvrzuje, že vlastnost vrátila eager. Příklad neměří, kdy se obrázek načítá. U obrázků zadejte width a height, aby se v rozvržení rezervovalo místo.

Příklady

<!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>

Výsledek

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

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje