CKTIS / HTML
loading — odraczanie ładowania zasobów
Atrybut loading określa, czy ładowanie zasobu może zostać odroczone ze względu na położenie elementu względem obszaru widocznego strony. Przyjmuje lazy albo eager; brak atrybutu i nieprawidłowa wartość oznaczają eager. Standard definiuje go dla img, iframe, audio i video.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
loading="eager" | loading="lazy"loading jest atrybutem wyliczeniowym, a nie logicznym ani globalnym. Dla img, iframe, audio i video wartość lazy odracza pobieranie do spełnienia warunków związanych z położeniem elementu. Wartość eager wyłącza to odroczenie; nie gwarantuje zakończenia ładowania ani wysokiego priorytetu. Brak atrybutu, pusty zapis loading="" i nieprawidłowe wartości, np. loading="false", oznaczają stan eager.
Przy lazy przeglądarka może rozpocząć pobieranie jeszcze przed wejściem elementu w widoczny obszar. Margines wyzwalający ładowanie zależy od implementacji, więc nie zakładaj konkretnej odległości ani czasu. Gdy wykonywanie skryptów jest wyłączone, mechanizm nie odracza ładowania — to zabezpieczenie przed śledzeniem przewijania. Kod JavaScript nie jest jednak potrzebny do samego użycia atrybutu.
W przypadku mediów lazy ma pierwszeństwo przed preload: najpierw odracza pobieranie, a po wznowieniu nadal obowiązują reguły preload. Odracza też rozpoczęcie odtwarzania przez autoplay oraz pobranie obrazu poster elementu video. audio bez controls nie jest wyświetlane, co uniemożliwia jego leniwe ładowanie. Obecność tych funkcji w standardzie nie potwierdza ich obsługi w każdej przeglądarce.
Właściwość DOM element.loading odzwierciedla atrybut, zwracając znane wartości; nieprawidłowa wartość daje eager. Zmiana stanu na eager wznawia oczekujące ładowanie. Przykład wyświetla wartości właściwości dla prawidłowych ustawień lazy i eager. Po ustawieniu loading="invalid" porównuje tylko image.loading z surową wartością atrybutu zwracaną przez image.getAttribute('loading'). Wynik false oznacza, że te wartości się różnią; nie potwierdza, że właściwość zwróciła eager. Przykład nie mierzy, kiedy obraz jest pobierany. Dla obrazów podawaj width i height, aby zarezerwować miejsce w układzie.
Przykłady
<!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>Wynik
Initial loading property: lazy After setting loading="eager": eager Invalid token preserved by the property: false
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.