CKTIS / HTML
srcset — liste de candidats d’image
L’attribut `srcset` fournit au navigateur des ressources d’image alternatives. Les descripteurs `x` indiquent la densité de pixels, tandis que les descripteurs `w` indiquent la largeur de la ressource, utilisée avec `sizes` pour choisir l’image.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
srcset="image.png 1x, image@2x.png 2x" | srcset="image-400.png 400w, image-800.png 800w" sizes="100vw"srcset est une liste d’URL d’images séparées par des virgules, avec des descripteurs facultatifs. Il s’applique à img et à source dans picture ; dans ce dernier cas, il est obligatoire, et l’élément img qui suit affiche l’image sélectionnée. Il ne remplace pas src sur source dans audio ou video.
Le descripteur 2x indique la densité, tandis que 800w indique la largeur intrinsèque de la ressource. Les valeurs doivent être positives et ne doivent pas être répétées. L’absence de descripteur signifie 1x. Ne mélangez pas w avec x ni avec des candidats sans descripteur.
Avec des candidats w, sizes est obligatoire pour img ; il décrit la largeur utilisée pour la sélection, et non la largeur de mise en page CSS. Dans ce cas, source exige aussi sizes, sauf si l’élément img qui suit autorise les tailles automatiques. Avec w, le navigateur ignore src lors de la sélection ; avec x, src peut fournir un candidat 1x si la liste n’en contient pas.
Le navigateur sélectionne une ressource selon les conditions d’affichage ; ne partez pas du principe qu’il existe une correspondance fixe avec la densité de l’écran. L’exemple intègre deux images et conserve la même apparence quel que soit le choix.
Exemples
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>srcset example</title>
<img
src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='royalblue'%20d='M0,0H40V40H0Z'/%3E%3C/svg%3E"
srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='royalblue'%20d='M0,0H40V40H0Z'/%3E%3C/svg%3E 1x, data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='80'%3E%3Cpath%20fill='royalblue'%20d='M0,0H80V80H0Z'/%3E%3C/svg%3E 2x"
width="40" height="40" alt="Blue square">
</html>Résultat
A royal-blue square displayed at 40 × 40 CSS pixels.
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.