HTMLImageElement: src-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die HTMLImageElement Eigenschaft src, die das HTML src-Attribut widerspiegelt, gibt das Bild an, das im <img> Element angezeigt werden soll.

Wert

Wenn nur ein einzelnes Bild bereitgestellt wird, anstatt eines Satzes von Bildern, aus dem der Browser das beste für die Viewport-Größe und Pixeldichte auswählt, ist das src-Attribut ein String, der die URL des gewünschten Bildes angibt. Dies kann entweder direkt im HTML durch das src Inhaltsattribut gesetzt werden oder programmgesteuert durch Setzen der src-Eigenschaft des Elements.

Wenn Sie das srcset Inhaltsattribut verwenden, um mehrere Bildoptionen für verschiedene Pixeldichten bereitzustellen, wird die URL, die durch das src-Attribut angegeben wird, auf eine von zwei Arten verwendet:

  • als Fallback für Browser, die srcset nicht unterstützen.
  • als Äquivalent zur Angabe eines Bildes in srcset mit dem Größemultiplikator 1x; das bedeutet, dass das durch src angegebene Bild auf Bildschirmen mit niedriger Dichte (wie typischen 72 DPI oder 96 DPI Displays) verwendet wird.

Wenn Sie src zusammen mit beiden sizes (oder dem entsprechenden sizes Inhaltsattribut) und srcset verwenden, um ein Bild basierend auf der Viewport-Größe zu wählen, wird das src-Attribut nur als Fallback für Browser verwendet, die sizes und srcset nicht unterstützen; ansonsten wird es überhaupt nicht verwendet.

Beispiele

Ein einzelnes Bild angeben

HTML

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

Ergebnis

Verwendung von src mit einem Bildsatz

Beim Verwenden eines Satzes von Bildern mit der srcset Eigenschaft dient src entweder als Fallback für ältere Browser oder als 1x Größe des Bildes.

HTML

Ergebnis

Ein Fallback für viewport-basierte Auswahl angeben

Bei der viewport-basierten Auswahl eines Bildes aus einem srcset durch gleichzeitige Angabe der sizes Eigenschaft dient die src-Eigenschaft als Fallback für Browser, die keine viewport-basierte Auswahl unterstützen. Browser, die eine viewport-basierte Auswahl unterstützen, werden src in diesem Fall ignorieren.

HTML

Ergebnis

Spezifikationen

Specification
HTML Standard
# dom-img-src

Browser-Kompatibilität

BCD tables only load in the browser