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 Eigenschaft src
des HTMLImageElement
, die das HTML-Attribut src
widerspiegelt, gibt das anzuzeigende Bild im <img>
-Element an.
Wert
Wenn Sie nur ein einzelnes Bild bereitstellen, anstatt eines Satzes von Bildern, aus dem der Browser die beste Anpassung an die Viewport-Größe und Pixeldichte auswählt, ist das src
-Attribut eine Zeichenkette, die die URL des gewünschten Bildes angibt. Dies kann entweder direkt im HTML mit dem src
-Inhaltsattribut oder programmatisch durch Setzen der src
-Eigenschaft des Elements festgelegt werden.
Wenn Sie das srcset
-Inhaltsattribut verwenden, um mehrere Bildoptionen für verschiedene Pixeldichten bereitzustellen, wird die durch das src
-Attribut angegebene URL auf eine von zwei Weisen verwendet:
- als Fallback für Browser, die
srcset
nicht unterstützen. - als Äquivalent zur Angabe eines Bildes in
srcset
mit dem Größenmultiplikator1x
; das heißt, das durchsrc
angegebene Bild wird auf Bildschirmen mit geringer Pixeldichte (wie typischen 72 DPI oder 96 DPI Displays) verwendet.
Darüber hinaus, wenn Sie src
zusammen mit sowohl sizes
(oder dem entsprechenden sizes
Inhaltsattribut) als auch srcset
verwenden, um ein Bild basierend auf der Viewport-Größe auszuwählen, wird das src
-Attribut nur als Fallback verwendet für Browser, die sizes
und srcset
nicht unterstützen; andernfalls 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
Bei der Verwendung eines Bildsatzes mit der srcset
-Eigenschaft dient src
entweder als Fallback für ältere Browser oder als 1x
-Größe des Bildes.
HTML
Ergebnis
Festlegen eines Fallbacks für Viewport-basierte Auswahl
Bei der Viewport-basierten Auswahl eines Bildes aus einem srcset
durch zusätzliches Angeben der sizes
-Eigenschaft dient die src
-Eigenschaft als Fallback, das auf Browsern verwendet wird, die die Viewport-basierte Auswahl nicht unterstützen. Browser, die die Viewport-basierte Auswahl unterstützen, ignorieren src
in dieser Situation.
HTML
Ergebnis
Spezifikationen
Specification |
---|
HTML # dom-img-src |