CKTIS / HTML
loading — het laden van bronnen uitstellen
Het attribuut loading bepaalt of het laden van een bron kan worden uitgesteld op basis van de positie van een element ten opzichte van het zichtbare paginagebied. Het accepteert lazy of eager; bij weglating of een ongeldige waarde geldt eager. De standaard definieert het voor img, iframe, audio en video.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
loading="eager" | loading="lazy"loading is een attribuut met opgesomde waarden, geen boolean- of globaal attribuut. Bij img, iframe, audio en video stelt lazy het ophalen uit totdat aan positiegerelateerde voorwaarden is voldaan. eager schakelt dit uitstel uit; het garandeert niet dat het laden is voltooid of een hoge prioriteit heeft. Als het attribuut ontbreekt, leeg is (loading="") of een ongeldige waarde heeft, zoals loading="false", geldt de toestand eager.
Met lazy kan de browser al beginnen met ophalen voordat het element in het zichtbare gebied komt. De afstand die het laden activeert, hangt af van de implementatie; ga dus niet uit van een bepaalde afstand of tijd. Als scripts niet worden uitgevoerd, stelt dit mechanisme het laden niet uit, als bescherming tegen het volgen van scrollgedrag. JavaScript is echter niet nodig om het attribuut te gebruiken.
Bij media heeft lazy voorrang op preload: eerst wordt het ophalen uitgesteld en wanneer het laden wordt hervat, blijven de regels van preload gelden. Ook het starten van afspelen via autoplay en het ophalen van de poster-afbeelding van een video-element worden uitgesteld. Een audio-element zonder controls wordt niet weergegeven en kan daarom niet lui worden geladen. Dat deze functies in de standaard staan, betekent niet dat elke browser ze ondersteunt.
De DOM-eigenschap element.loading weerspiegelt het attribuut en geeft bekende waarden terug; een ongeldige waarde levert eager op. Als de toestand wordt gewijzigd in eager, wordt het uitgestelde laden hervat. Het voorbeeld toont de waarden van de eigenschap voor de geldige instellingen lazy en eager. Na het instellen van loading="invalid" vergelijkt het alleen image.loading met de onbewerkte attribuutwaarde die image.getAttribute('loading') teruggeeft. De uitkomst false geeft aan dat de twee waarden verschillen; die bevestigt niet dat de eigenschap eager heeft teruggegeven. Het voorbeeld meet niet wanneer de afbeelding wordt opgehaald. Geef bij afbeeldingen width en height op om ruimte in de lay-out te reserveren.
Voorbeelden
<!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>Resultaat
Initial loading property: lazy After setting loading="eager": eager Invalid token preserved by the property: false
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.