Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

imagesizes — taille de la source d’image pour le préchargement

L’attribut imagesizes décrit la largeur attendue d’une image afin que le navigateur puisse choisir une ressource dans imagesrcset lors du préchargement. Il s’applique à link avec rel="preload" et as="image" ; il ne définit pas la largeur de mise en page de l’image.

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

Syntaxe

<link rel="preload" as="image" imagesrcset="…" imagesizes="(max-width: 600px) 100vw, 50vw">

imagesizes indique la taille de source utilisée pour choisir une image dans imagesrcset. Cet attribut n’est autorisé que sur un élément link avec rel="preload" et as="image". Si imagesrcset contient des descripteurs de largeur w, imagesizes est obligatoire.

Sa valeur est une liste de tailles de source, comme pour sizes sur une image : (max-width: 600px) 100vw, 50vw signifie la largeur totale de la fenêtre jusqu’à 600 pixels CSS, puis la moitié de cette largeur. La première condition correspondante s’applique ; la dernière longueur sert de valeur par défaut. Les pourcentages ne sont pas autorisés comme longueurs de taille de source.

Faites correspondre imagesizes au sizes de l’image cible et imagesrcset à son srcset, afin que les deux étapes sélectionnent une ressource cohérente. La déclaration décrit la largeur attendue, mais ne la définit pas — configurez la mise en page séparément, par exemple avec CSS. Ne confondez pas non plus cet attribut avec sizes de l’élément link, qui décrit les dimensions des icônes.

L’exemple utilise deux variantes SVG intégrées (80w et 160w), chacune contenant un rectangle bleu-vert. Aucun fichier séparé n’est donc nécessaire. imagesizes et sizes ont tous deux la valeur fixe 80px, quelle que soit la largeur de la zone d’affichage. La console confirme que ces valeurs correspondent et affiche séparément la taille de source de 80px et la largeur de mise en page de 64px, définie en CSS. L’exemple ne mesure pas si le préchargement accélère le téléchargement.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Source size for image preloading</title>
  <link id="preload" rel="preload" as="image" imagesizes="80px"
        imagesrcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='40'%3E%3Crect%20width='80'%20height='40'%20fill='teal'/%3E%3C/svg%3E 80w,
                     data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='80'%3E%3Crect%20width='160'%20height='80'%20fill='teal'/%3E%3C/svg%3E 160w">
  <style>
    #sample { display: block; width: 64px; height: auto; }
  </style>
</head>
<body>
  <h1>Preload source size and layout width</h1>
  <img id="sample" alt="Teal rectangle" width="80" height="40" sizes="80px"
       src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='40'%3E%3Crect%20width='80'%20height='40'%20fill='teal'/%3E%3C/svg%3E"
       srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='40'%3E%3Crect%20width='80'%20height='40'%20fill='teal'/%3E%3C/svg%3E 80w,
               data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='80'%3E%3Crect%20width='160'%20height='80'%20fill='teal'/%3E%3C/svg%3E 160w">
  <script>
    const preload = document.getElementById('preload');
    const image = document.getElementById('sample');
    if ('imageSizes' in preload) {
      console.log(`Preload source size: ${preload.imageSizes}`);
      console.log(`Preload and image source sizes match: ${preload.imageSizes === image.sizes}`);
      console.log(`Image layout width: ${getComputedStyle(image).width}`);
    } else {
      console.log('imagesizes reflection is unsupported');
    }
  </script>
</body>
</html>

Résultat

Preload source size: 80px
Preload and image source sizes match: true
Image layout width: 64px

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.

Sources