HTMLImageElement: src property - Web APIs | MDN (original) (raw)

Baseline

Widely available

The HTMLImageElement property**src**, which reflects the HTML src attribute, specifies the image to display in the element.

Value

When providing only a single image, rather than a set of images from which the browser selects the best match for the viewport size and display pixel density, thesrc attribute is a string specifying the URL of the desired image. This can be set either within the HTML itself using thesrc content attribute, or programmatically by setting the element's src property.

If you use the srcset content attribute to provide multiple image options for different display pixel densities, the URL specified by thesrc attribute is used in one of two ways:

Additionally, if you use src along with both sizes (or the corresponding sizes content attribute) and srcset in order to choose an image based on the viewport size, thesrc attribute is only used as a fallback for browsers that don't supportsizes and srcset; otherwise, it's not used at all.

Examples

Specifying a single image

HTML

<img
  src="grapefruit-slice-332-332.jpg"
  width="160"
  alt="Slices of grapefruit, looking yummy." />

Result

Using src with an image set

When using a set of images with the srcsetproperty, the src serves as either a fallback for older browsers, or as the1x size of the image.

HTML

Result

Specifying a fallback for viewport-based selection

When using viewport-bases selection of an image from a srcset by also specifying the sizes property, thesrc property serves as the fallback to be used on browsers that don't support viewport-based selection. Browsers that do support viewport-based selection will ignore src in this situation.

HTML

Result

Specifications

Specification
HTML # dom-img-src

Browser compatibility