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

CKTIS / HTML

sizes — largeur pour la sélection des images et dimensions des icônes

L’attribut sizes a deux significations distinctes : sur img et source, il décrit la largeur de l’image utilisée pour choisir une ressource dans srcset ; sur link, il indique les dimensions des icônes disponibles. Il ne remplace pas les règles CSS qui déterminent la taille affichée de l’image.

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

Syntaxe

img/source: sizes="(media-condition) length, fallback-length" | sizes="auto, fallback-length"
link: sizes="16x16 32x32" | sizes="any"

Sur img et sur source à l’intérieur de picture, sizes décrit la largeur prévue de l’image dans la mise en page. Le navigateur l’associe aux candidats de srcset dotés de descripteurs de largeur, comme 640w, pour choisir une ressource. C’est une indication pour sélectionner un fichier, et non une instruction de modifier les dimensions CSS. L’attribut ne sert pas à choisir entre des candidats portant les descripteurs 1x et 2x.

La liste est séparée par des virgules, par exemple (max-width: 600px) 100vw, 50vw. La première condition satisfaite fournit la largeur ; une longueur finale sans condition sert de valeur de repli. Les longueurs doivent être positives ou nulles ; des unités comme px, em, vw et des fonctions mathématiques comme calc() sont autorisées, mais pas les pourcentages. Si l’analyse ne trouve aucune valeur utilisable, elle renvoie 100vw.

Sur img, l’utilisation de descripteurs w nécessite sizes. La même règle s’applique à source, sauf si l’élément img qui suit autorise une taille automatique. Pour utiliser sizes="auto", cet élément img doit avoir loading="lazy", et son propre attribut sizes doit être égal à auto ou commencer par auto,. auto doit être en première position ; des valeurs de repli peuvent suivre. La largeur provient alors de la taille de l’image rendue. Indiquez également les dimensions avec width et height ou en CSS. Dans ce cas, omettre sizes sur un source précédent équivaut à auto.

Sur link, le sens est différent : sizes indique à titre informatif les dimensions des icônes disponibles et n’est autorisé que si rel contient icon ou apple-touch-icon. La valeur est composée de jetons uniques séparés par des espaces, comme 16x16 32x32, ou de any pour toute taille. Les paires indiquent la largeur et la hauteur en pixels ; les nombres sont positifs et sans zéro initial, séparés par x ou X. La casse ASCII des jetons n’est pas prise en compte. Pour le préchargement d’images avec link, l’attribut correspondant est imagesizes, et non sizes.

L’exemple intègre un SVG sans fichier externe. Le CSS définit les dimensions réelles, tandis que sizes="160px" décrit la même largeur pour la sélection de la source. La lecture de l’attribut produit un texte prévisible ; elle ne teste pas l’algorithme de sélection des ressources.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>sizes</title>
<style>img { display: block; width: 160px; height: 80px; }</style>
<img id="sample" alt="Blue rectangle" width="160" height="80"
     sizes="160px"
     srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='80'%3E%3Cpath%20fill='blue'%20d='M0,0H160V80H0Z'/%3E%3C/svg%3E 160w">
<pre id="result"></pre>
<script>
  document.getElementById('result').textContent =
    'sizes=' + document.getElementById('sample').getAttribute('sizes');
</script>
</html>

Résultat

sizes=160px

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