Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLSourceElement : propriété srcset

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨mars 2017⁩.

La propriété srcset de l'interface HTMLSourceElement est une chaîne de caractères contenant une liste, séparée par des virgules, d'images candidates.

Chaque image candidate inclut l'URL d'une ressource image à utiliser comme source pour l'élément et, éventuellement, un descripteur indiquant les circonstances dans lesquelles l'image doit être utilisée. Le descripteur est soit un nombre suivi de 'w', indiquant la largeur de l'élément, soit un nombre suivi de 'x', indiquant la densité de pixels de l'appareil.

Elle reflète l'attribut srcset de l'élément HTML <source> imbriqué dans un élément HTML <picture>. Elle n'a pas de sens et est ignorée lorsqu'elle est imbriquée dans un élément HTML <audio> ou <video>, qui utilisent à la place l'attribut src.

Valeur

Une chaîne de caractères.

Exemples

html
<picture>
  <source
    id="el"
    srcset="smile.png, smile-1.5x.png 1.5x, smile-2x.png 2x"
    type="image/png" />
</picture>
js
const el = document.getElementById("el");
console.log(el.srcset); // Affiche : "smile.png, smile-1.5x.png 1.5x, smile-2x.png 2x"
el.srcset = "smile.png, smile-med.png 600w, smile-large.png 800w"; // Met à jour la valeur de srcset

Spécifications

Specification
HTML
# dom-source-srcset

Compatibilité des navigateurs

Voir aussi