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ößemultiplikator1x
; das bedeutet, dass das durchsrc
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
<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