Décalage de mise en page causé par les images (CLS) : width, height et aspect-ratio

Width et height pour les images et la vidéo, aspect-ratio pour les iframes, et pourquoi le width: auto d'un thème, un lazy loader ou un carrousel peut encore décaler la page.

  • Bon ≤ 0,1
  • À améliorer ≤ 0,25
  • Mauvais > 0,25
Arjen Karel
Mis à jour le · 11 min de lecture
Partager

Le décalage de mise en page causé par les images en bref

Une image, une vidéo ou une iframe décale la page quand le navigateur ne connaît pas sa hauteur avant l'arrivée du fichier. Des attributs width et height indiquant la taille en pixels du fichier, associés à max-width: 100%; height: auto dans le CSS, réservent le bon espace quelle que soit la largeur d'écran. Une iframe ne tire aucun ratio de ses attributs et nécessite aspect-ratio en CSS.

Pourquoi une image sans largeur ni hauteur décale-t-elle la page ?

Le navigateur calcule la mise en page avant l'arrivée de la photo. Une balise <img> sans largeur ni hauteur n'occupe aucune hauteur tant que le fichier n'est pas arrivé ; le navigateur découvre ensuite la taille de la photo et tout le contenu situé sous l'image chute d'autant. Cette chute constitue un layout shift, qui compte dans le Cumulative Layout Shift (CLS) de la page.

Sur une page produit de test contenant une photo au-dessus du prix et huit paragraphes, chargée dans Chrome au format mobile avec une photo arrivant après le premier affichage, le texte a chuté de 196 pixels : soit un CLS de 0,19 lors de la première visite. Lors de la seconde visite, la photo étant dans le cache du navigateur, le CLS était de 0. L'absence de dimensions décale donc la page pour les nouveaux visiteurs, et vous, avec la photo dans votre cache, ne le remarquerez probablement jamais.

A test product page at phone width on a first visit, before the photo arrives: the heading Cast iron skillet, 26 cm, with the price EUR 49 and the text directly under it and no space kept for the photo.

Avant

The same test product page once the photo has arrived: a 16:9 photo of eggs in a skillet between the heading and the price, and the price and the text 196 pixels lower than before.

Après

La page produit de test au format mobile lors d'une première visite, sans largeur ni hauteur sur la photo.

Comment définir une largeur et une hauteur sur chaque image ?

Renseignez les attributs width et height de chaque balise <img> avec la taille en pixels du fichier, et ajoutez img { max-width: 100%; height: auto; } dans le CSS. Le navigateur convertit ces deux valeurs en ratio et réserve la hauteur avant l'arrivée du fichier, quelle que soit la largeur d'écran.

  • WordPress : WordPress renseigne ces deux attributs pour les images ajoutées aux articles et aux pages depuis la médiathèque ; les images générées directement par un thème, un page builder, un slider ou un plugin en sont dépourvues. WP Rocket (Media, Add Missing Image Dimensions) et Perfmatters (Lazy Loading, Add Missing Image Dimensions) les ajoutent aux images hébergées sur votre domaine. Plus de détails par plugin dans le guide WordPress.
  • Shopify : le filtre image_tag génère les deux attributs. Une section de thème ou une application qui affiche sa propre balise <img> a besoin de width="{{ image.width }}" height="{{ image.height }}" ; le guide Shopify détaille le reste.
  • Next.js : next/image accepte une largeur et une hauteur, ou fill à l'intérieur d'un parent doté de ses propres dimensions.

Dans un template :

<img src="skillet.jpg" width="1200" height="675" alt="Cast iron skillet">
img {
    max-width: 100%;
    height: auto;
}

height: auto calcule la hauteur à partir du ratio, et max-width maintient l'image dans sa colonne. Chrome DevTools affiche ce ratio dans Styles sous img[Attributes Style] sous la forme aspect-ratio: auto 1200 / 675, même si un width: auto dans le thème l'annule. Vérifiez donc l'image elle-même : rechargée avec le cache désactivé, elle a déjà sa hauteur avant l'arrivée du fichier.

D'après le rapport State of Web Vitals, 92 % des sites dont toutes les images de la page d'accueil ont une largeur et une hauteur réussissent le CLS sur mobile, contre 88 % pour les sites ayant au moins une image sans dimensions. C'est une corrélation.

Que signifie « Image elements do not have explicit width and height » ?

Le diagnostic de Lighthouse « Image elements do not have explicit width and height » liste chaque image de la page dépourvue de largeur ou de hauteur, que ce soit via ses attributs ou son CSS, à moins qu'un aspect-ratio en CSS ne compense l'absence. Ce diagnostic n'a aucun poids dans le score Performance, mais chaque image listée peut décaler la page pour un premier visiteur. Le fix consiste à indiquer les dimensions réelles du fichier sur chaque image listée : WP Rocket et Perfmatters peuvent les ajouter sous WordPress, et le filtre image_tag de Shopify s'en charge.

Lighthouse considère qu'une image est dimensionnée dès que les deux attributs figurent dans le HTML ; une image dont le thème applique width: auto passe donc le test tout en continuant de décaler la page.

L'insight Layout shift culprits tente de deviner la cause d'un décalage d'après son timing. Sa ligne « Unsized image element » peut donc incriminer une image qui a seulement été poussée : vérifiez que l'image manque réellement de dimensions avant de la modifier (comment vérifier).

Pourquoi une image dotée d'une largeur et d'une hauteur décale-t-elle quand même la page ?

Une règle de thème width: auto sur les images annule les attributs width et height : l'image retombe à une hauteur nulle tant que le fichier n'est pas arrivé, exactement comme si les attributs étaient absents. Des attributs dont le ratio diffère de celui du fichier décalent aussi la page, à hauteur de la différence : utilisez toujours les dimensions réelles du fichier.

CLS sur la page produit de test selon la configuration :

Configuration de l'image Première visite Seconde visite
Sans largeur ni hauteur 0,19 0
Largeur et hauteur, thème appliquant width: auto 0,19 0
Identique, plus aspect-ratio: 16 / 9 0,19 0
800 par 600 sur une photo 16:9 0,05 0
Largeur et hauteur, max-width: 100%; height: auto 0 0

Dans la feuille de style du thème, la règle ressemble généralement à ceci :

img {
    width: auto;
    height: auto;
    max-width: 100%;
}

Avec width: auto, la largeur provient du fichier. Tant que le fichier n'est pas arrivé, l'image fait 0 pixel de large et le ratio lui donne une hauteur de 0. Supprimez width: auto et conservez height: auto ainsi que max-width: 100% ; ajouter aspect-ratio à côté ne règle pas le problème.

Chrome DevTools Elements panel on the test product page: the img with width 1200 and height 675 selected; in Styles the theme rule img with width: auto, height: auto and max-width: 100%, and under it img[Attributes Style] with width 1200px and height 675px struck through and aspect-ratio: auto 1200 / 675 still listed.

Chrome DevTools sur la page produit de test avant l'arrivée de la photo : les propriétés width: auto et height: auto du thème écrasent le 1200 et 675 des attributs, aspect-ratio apparaît toujours, et l'image fait 0 par 0 pixel.

Add Missing Image Dimensions (WP Rocket, Perfmatters) se contente d'ajouter les attributs. Sans accès au code du thème, surchargez la règle : sous WordPress dans Apparence > Personnaliser > CSS additionnel (avec un thème basé sur des blocs, Éditeur de site > Styles > CSS additionnel), sous Shopify dans Boutique en ligne > Modifier le thème > Paramètres du thème > CSS personnalisé :

/* the selector DevTools shows next to width: auto */
.entry-content img {
    width: revert-layer;
}

width: revert-layer redonne à l'image la largeur de ses attributs, et le max-width: 100% du thème continue de l'adapter à la colonne. Sur la page produit de test dans Chrome, cette surcharge a fait passer le CLS de 0,19 à 0 et a maintenu une image de 200 pixels à 200 pixels ; width: 100% donnait aussi 0, mais étirait cette image sur toute la colonne. Une mise à jour du thème conserve la règle tant que le sélecteur ne change pas. Si la règle du thème pour l'image se trouve dans un @layer, revert-layer rétablit cette règle et l'image continue de décaler la page ; utilisez alors width: 100% là où chaque image remplit la colonne, ou demandez au développeur du thème de modifier la règle dans son layer. L'article sur les images avec taille automatique détaille l'ensemble du problème.

Quand utiliser plutôt aspect-ratio en CSS ?

Une largeur et un ratio en CSS réservent l'espace pour une image dont le template ne peut pas générer les attributs width et height. Sur la page produit de test, une image sans attributs, avec width: 100% et aspect-ratio: 16 / 9, a conservé son espace aussi bien qu'avec des attributs, soit un CLS de 0.

img.hero {
    width: 100%;
    height: auto;
    aspect-ratio: 16 / 9;
}

Pour une grille de photos de produits aux formats hétérogènes, donnez à chaque image le même cadre et laissez object-fit: cover recadrer chaque photo :

.product-image {
    width: 100%;
    aspect-ratio: 1 / 1;
    object-fit: cover;
}

Combiné à un width: auto issu du thème, aspect-ratio ne dispose d'aucune largeur sur laquelle s'appuyer et laisse l'image à une hauteur nulle jusqu'à l'arrivée du fichier : supprimez d'abord le width: auto.

Comment empêcher les vidéos, iframes et embeds de décaler la page ?

Une balise <video> dotée d'une largeur et d'une hauteur réserve son espace comme une image, à condition que son image poster partage le même ratio que la vidéo. Une <iframe> ne tire aucun ratio de sa largeur et de sa hauteur : avec height: auto, elle fait 150 pixels de haut quelle que soit sa largeur. Elle nécessite donc un aspect-ratio en CSS, ou une image fixe dans un conteneur aux dimensions finales qui chargera l'iframe plus tard.

<video src="skillet.mp4" poster="skillet.jpg" width="1280" height="720" controls></video>

La vidéo utilise la même règle max-width: 100%; height: auto qu'une image. Sur la page produit de test, une vidéo sans largeur ni hauteur n'occupait aucune hauteur avant l'arrivée de son poster, puis repoussait le texte de 214 pixels vers le bas : soit un CLS de 0,21, contre 0 avec les attributs. Le ratio du poster prend le dessus dès que celui-ci arrive ; un poster avec un format différent décale donc la page.

Sur la page produit de test, une <iframe width="560" height="315"> en pleine largeur mesurait 380 par 150 pixels sur mobile, et 380 par 214 en ajoutant aspect-ratio :

iframe {
    width: 100%;
    height: auto;
    aspect-ratio: 16 / 9;
}

Un script d'intégration qui insère ou redimensionne l'iframe après le chargement décale la page à chaque visite : attribuez les dimensions finales au conteneur parent. Pour YouTube et Google Maps, j'affiche sur la page une image de remplacement aux dimensions définitives et je charge l'iframe à la première interaction. Rien ne bouge, que l'iframe apparaisse au tap, au survol ou lors du défilement dans le viewport ; le code est disponible dans intégrations YouTube parfaites et Google Maps sans perdre en PageSpeed.

Un SVG dans une balise <img> a besoin d'une largeur et d'une hauteur comme n'importe quelle autre image. Les encarts publicitaires ont leur propre solution dans le guide CLS.

Quelles largeur et hauteur appliquer sur srcset et picture ?

Tous les fichiers d'un même srcset doivent avoir le même ratio : un seul couple width et height sur la balise <img> convient ainsi à n'importe quel fichier choisi par le navigateur. Une balise <picture> avec un recadrage différent sur mobile reçoit une largeur et une hauteur sur chaque <source>, et Chrome, Firefox comme Safari les prennent tous en charge.

<picture>
    <source media="(max-width: 799px)" srcset="skillet-phone.jpg" width="800" height="600">
    <img src="skillet.jpg" width="1200" height="675" alt="Cast iron skillet">
</picture>

Sur la page produit de test avec un recadrage 4:3 pour mobile, la balise <source> dotée de ses propres dimensions a donné un CLS de 0. Sans elles, le navigateur réservait l'espace au format 16:9 de l'<img>, et le texte descendait de 71 pixels à l'arrivée de la photo 4:3 : soit un score de 0,05.

Les poids de fichiers et les formats recommandés pour le srcset sont détaillés dans Améliorer la diffusion des images.

Le lazy loading et les carrousels provoquent-ils des décalages de mise en page ?

L'attribut natif loading="lazy" sur une image dotée d'une largeur et d'une hauteur ne décale rien, car l'espace est réservé avant le chargement du fichier. Un script de lazy loading dont le placeholder dans le src de l'image présente un format différent de la photo décale la page au moment où la photo le remplace, et ce à chaque visite. Un carrousel qui déplace ses slides avec la propriété CSS left décale la page à chaque diapositive ; celui qui les anime avec un transform maintient le CLS à 0.

Sur la page produit de test, un script avec un GIF transparent de 1 par 1 pixel en placeholder rendait le conteneur de la photo carré malgré les attributs width et height, jusqu'à ce que la photo prenne le relais : soit un CLS de 0,11 à la première visite comme à la seconde, car le script remplace le fichier à chaque fois. Un placeholder reporte le décalage au moment où la photo le remplace, à moins d'avoir déjà le même ratio que celle-ci : appliquez-lui le ratio final, ou utilisez le lazy loading natif.

Une image en lazy loading sans dimensions décale la page si son fichier arrive alors qu'elle est déjà visible après un scroll. Ce décalage compte dans le CLS, et un test Lighthouse ne scrolle jamais.

WordPress ajoute automatiquement loading="lazy" aux images du contenu ; conservez un seul système de lazy loading, celui de WordPress ou celui d'un plugin dont le placeholder respecte le ratio de l'image. La photo du premier écran et le premier slide d'un carrousel ne doivent jamais être en lazy loading : la découverte des requêtes LCP explique pourquoi.

Un carrousel en lecture automatique qui déplaçait ses slides avec left affichait un CLS de 0,22 lors des deux visites : un défilement automatique ne résulte d'aucune action du visiteur, chaque mouvement est donc pénalisé. Avec transform: translateX(), le CLS était de 0, car une transformation déplace les diapositives sans nouveau layout. Donnez un ratio fixe au carrousel et animez uniquement le transform :

.carousel {
    aspect-ratio: 16 / 9;
    overflow: hidden;
}
.carousel .track {
    transition: transform .6s; /* the script changes transform, never left */
}

Comment trouver l'image qui décale la page ?

Les field data listent l'élément qui s'est déplacé, et une image qui pousse la page apparaît sous la forme de l'élément situé en dessous : regardez ce qui se trouve directement au-dessus de l'élément désigné. S'il s'agit d'une image, d'une vidéo ou d'une iframe, la solution se trouve sur cette page.

Sur la page produit de test, chaque décalage causé par l'image a été enregistré sur les paragraphes situés sous la photo, car celle-ci s'agrandit vers le bas depuis un bord supérieur immobile. Dans CoreDash, groupez le CLS sur mobile par Attribution Element (CLS), prenez une ligne avec un p75 CLS élevé, ouvrez une page contenant cet élément et regardez juste au-dessus. Un décalage issu d'une image lazy sans dimensions survient après un scroll : Last Interaction (CLS) permet de l'identifier.

CoreDash, Cumulative Layout Shift by Attribution Element (CLS): per element the p75 CLS, a performance label, the distribution and the sessions; the rows include main#main.site-main, the recipe name, an in-content ad slot, the nav and the footer.

CoreDash, CLS par Attribution Element (CLS) : chaque ligne correspond à un élément qui s'est déplacé ; l'image à corriger se trouve directement au-dessus sur la page.

Testez avec Disable cache activé pour que Chrome charge la page comme un premier visiteur la découvre : dans Chrome DevTools, cochez Disable cache dans l'onglet Network, sélectionnez Slow 4G et rechargez au format mobile. Core Web Vitals Visualizer, une extension Chrome gratuite, affiche une surcouche sur tout ce qui a bougé. La méthode complète est détaillée dans identifier et corriger les problèmes de CLS.

Comment vérifier que l'image ne décale plus la page ?

Rechargez la page dans Chrome DevTools avec Disable cache activé et Slow 4G : l'image possède sa hauteur avant l'arrivée du fichier, et un enregistrement du rechargement dans le panneau Performance ne montre aucun layout shift en dessous. Dans les données réelles, l'élément situé sous l'image disparaît de la liste Attribution Element (CLS) en quelques jours, et la Search Console met jusqu'à 28 jours à suivre.

Certaines images tirent leurs dimensions d'un code que vous ne pouvez pas modifier : un page builder ou un slider sans réglage prévu pour cela, ou une application qui génère sa propre balise d'image. Dans une session Core Web Vitals power hour, nous ouvrons ce template ensemble pour déterminer où placer la largeur et la hauteur.

About the author

Arjen Karel is a web performance consultant and the creator of CoreDash, a Real User Monitoring platform that tracks Core Web Vitals data across hundreds of sites. He also built the Core Web Vitals Visualizer Chrome extension. He has helped clients achieve passing Core Web Vitals scores on over 925,000 mobile URLs.

Arjen Karel

Besoin d'un site plus rapide ?

Je suis Arjen et je répare des sites lents depuis 17 ans. Si vous rencontrez des problèmes que vous ne pouvez pas résoudre vous-même, envoyez-moi votre URL et parlons-en.

Envoyez-moi votre URL
Arjen Karel
Arjen Karel, Consultant en performance web depuis 2009

Pourquoi notre fix ne fonctionne pas ?

Parfois le CDN sert encore l'ancien HTML, ou le fix a été appliqué sur le template desktop alors que le mobile en utilise un autre. Envoyez-moi votre URL et le problème, et je vous réponds avec quelques créneaux. J'analyse d'abord vos field data, puis nous passons une heure sur votre site, et sous 24 heures vous avez mes notes par écrit. 350 € HT.

Envoyez-moi votre URL

Pas de développeur pour réaliser le fix ? Je fais le travail moi-même, sur une copie de votre site.

Arjen KarelCLS encore rouge sur mobile ?Envoyez-moi votre URL