HTMLSourceElement : propriété srcset

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

<picture>
 <source
 id="el"
 srcset="smile.png, smile-1.5x.png 1.5x, smile-2x.png 2x"
 type="image/png" />
</picture>

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

Compatibilité des navigateurs

Voir aussi

• La propriété HTMLSourceElement.type
• La propriété HTMLSourceElement.src
• La propriété HTMLSourceElement.media
• La propriété HTMLSourceElement.sizes
• L'élément HTML <source>
• L'élément HTML <picture>