HTMLSourceElement: srcset property

The srcset property of the HTMLSourceElement interface is a string containing a comma-separated list of candidate images.

Each candidate image includes the URL of an image resource to use as the source for the element and optionally a descriptor indicating the circumstances in which the image should be used. The descriptor is either a number followed by 'w', indicating the element width, or a number followed by 'x', indicating the device pixel density.

It reflects the srcset attribute of the <source> element nested in a <picture> element. It has no meaning and is ignored when it is nested in an <audio> or <video> element, which use the src attribute instead.

Value

A string.

Examples

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

const el = document.getElementById("el");
console.log(el.srcset); // Output: "smile.png, smile-1.5x.png 1.5x, smile-large 800w"
el.srcset = "smile.png, smile-med.png 600w, smile-large.png 800w"; // Updates the srcset value

Specifications

Browser compatibility

See also

• HTMLSourceElement.type
• HTMLSourceElement.src
• HTMLSourceElement.media
• HTMLSourceElement.sizes
• <source>
• <picture>