CKTIS / HTML
loading — différer le chargement des ressources
L’attribut loading indique si le chargement d’une ressource peut être différé selon la position de l’élément par rapport à la zone visible de la page. Il accepte lazy ou eager ; s’il est absent ou contient une valeur invalide, eager s’applique. Le standard le définit pour img, iframe, audio et video.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
loading="eager" | loading="lazy"loading est un attribut à valeurs énumérées, et non un attribut booléen ou global. Sur img, iframe, audio et video, lazy diffère la récupération jusqu’à ce que des conditions liées à la position soient réunies. eager désactive ce report ; il ne garantit ni la fin du chargement ni une priorité élevée. Si l’attribut est absent, vide (loading="") ou invalide, par exemple loading="false", l’état eager s’applique.
Avec lazy, le navigateur peut commencer la récupération avant que l’élément n’entre dans la zone visible. La marge qui déclenche le chargement dépend de l’implémentation ; ne partez donc pas du principe qu’une distance ou un délai précis s’applique. Lorsque l’exécution des scripts est désactivée, ce mécanisme ne diffère pas le chargement, afin de limiter le suivi du défilement. Il n’est toutefois pas nécessaire d’utiliser JavaScript pour employer cet attribut.
Pour les médias, lazy a priorité sur preload : la récupération est d’abord différée, puis les règles de preload continuent de s’appliquer lorsque le chargement reprend. Il diffère également le début de la lecture déclenchée par autoplay et la récupération de l’image poster d’un élément video. Un élément audio sans controls n’est pas affiché, ce qui empêche son chargement différé. La présence de ces fonctionnalités dans le standard ne garantit pas leur prise en charge par tous les navigateurs.
La propriété DOM element.loading reflète l’attribut et renvoie les valeurs connues ; une valeur invalide donne eager. Passer à l’état eager reprend le chargement en attente. L’exemple affiche les valeurs de la propriété pour les réglages valides lazy et eager. Après avoir défini loading="invalid", il se contente de comparer image.loading à la valeur brute de l’attribut renvoyée par image.getAttribute('loading'). Le résultat false indique que les deux valeurs diffèrent ; il ne confirme pas que la propriété a renvoyé eager. L’exemple ne mesure pas à quel moment l’image est récupérée. Indiquez width et height pour les images afin de réserver de l’espace dans la mise en page.
Exemples
<!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>Résultat
Initial loading property: lazy After setting loading="eager": eager Invalid token preserved by the property: false
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.