Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

<img>: HTML-Element zum Einbetten von Bildern

Baseline
Weitgehend verfügbar
*

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Das <img>-Element von HTML bettet ein Bild in das Dokument ein.

Probieren Sie es aus

<img
  class="fit-picture"
  src="/p/https://developer.mozilla.org/shared-assets/images/examples/grapefruit-slice.jpg"
  alt="Grapefruit slice atop a pile of other slices" />
.fit-picture {
  width: 250px;
}

Attribute

Dieses Element unterstützt die globalen Attribute.

alt

Definiert Text, der das Bild auf der Seite ersetzen kann.

Hinweis: Browser zeigen Bilder nicht immer an. Ein Browser zeigt Bilder beispielsweise in folgenden Situationen möglicherweise nicht an:

  • Nicht visuelle Browser, etwa solche, die von Menschen mit Sehbehinderungen verwendet werden
  • Die Person entscheidet sich dagegen, Bilder anzuzeigen, etwa um Bandbreite zu sparen oder aus Datenschutzgründen
  • Das Bild ist ungültig oder hat einen nicht unterstützten Dateityp

In diesen Fällen kann der Browser das Bild durch den Text im alt-Attribut des Elements ersetzen. Geben Sie deshalb nach Möglichkeit immer einen aussagekräftigen Wert für alt an.

Wenn Sie dieses Attribut auf eine leere Zeichenfolge setzen (alt=""), bedeutet dies, dass das Bild kein wesentlicher Teil des Inhalts ist, sondern beispielsweise der Dekoration oder als Tracking-Pixel dient. Nicht visuelle Browser können es dann beim Rendern auslassen. Visuelle Browser blenden außerdem das Symbol für ein fehlerhaftes Bild aus, wenn das alt-Attribut leer ist und das Bild nicht angezeigt werden konnte.

Dieses Attribut wird auch verwendet, wenn das Bild als Text kopiert und eingefügt oder ein verlinktes Bild als Lesezeichen gespeichert wird.

attributionsrc

Gibt an, dass der Browser zusammen mit der Bildanfrage einen Attribution-Reporting-Eligible-Header senden soll.

Serverseitig wird dadurch ausgelöst, dass in der Antwort ein Attribution-Reporting-Register-Source- oder Attribution-Reporting-Register-Trigger-Header gesendet wird, um eine bildbasierte Attributionsquelle beziehungsweise einen Attributionstrigger zu registrieren. Welcher Antwort-Header gesendet werden soll, hängt vom Wert des Attribution-Reporting-Eligible-Headers ab, der die Registrierung ausgelöst hat.

Das entsprechende Quellen- oder Triggerereignis wird ausgelöst, sobald der Browser die Antwort mit der Bilddatei erhält.

Hinweis: Weitere Informationen finden Sie unter Attribution Reporting API.

Sie können dieses Attribut auf zwei Arten angeben:

  • Als boolesches Attribut, also nur mit dem Namen attributionsrc. Damit legen Sie fest, dass der Attribution-Reporting-Eligible-Header an denselben Server gesendet wird, auf den das src-Attribut verweist. Dies eignet sich, wenn Sie die Registrierung der Attributionsquelle oder des Triggers auf demselben Server verarbeiten. Bei der Registrierung eines Attributionstriggers ist diese Eigenschaft optional; wird sie weggelassen, wird ein boolescher Wert verwendet.
  • Mit einem Wert, der eine oder mehrere URLs enthält, zum Beispiel:
html
<img
  src="image-file.png"
  alt="My image file description"
  attributionsrc="https://a.example/register-source
                     https://b.example/register-source" />

Dies ist nützlich, wenn die angeforderte Ressource nicht auf einem von Ihnen kontrollierten Server liegt oder Sie die Registrierung der Attributionsquelle auf einem anderen Server verarbeiten möchten. In diesem Fall können Sie als Wert von attributionsrc eine oder mehrere URLs angeben. Bei der Ressourcenanfrage wird der Attribution-Reporting-Eligible-Header zusätzlich zum Ursprungsserver der Ressource an die in attributionSrc angegebenen URLs gesendet. Diese URLs können mit einem Attribution-Reporting-Register-Source- oder Attribution-Reporting-Register-Trigger-Header antworten und so die Registrierung abschließen.

Hinweis: Wenn Sie mehrere URLs angeben, können für dieselbe Funktion mehrere Attributionsquellen registriert werden. Beispielsweise könnten Sie den Erfolg verschiedener Kampagnen messen, für die unterschiedliche Berichte über unterschiedliche Daten erstellt werden.

controls

Ein boolesches Attribut, das vom User-Agent definierte Bedienelemente für das Bild aktiviert, beispielsweise eine Schaltfläche zur Vollbildansicht. Ereignisse aus Benutzerinteraktionen mit diesen Bedienelementen werden unterdrückt. Welche Bedienelemente bereitgestellt werden, hängt von der Implementierung ab. Unterstützende User-Agents können beispielsweise integrierte Benutzeroberflächen zur Interaktion mit räumlichen Bildern und Panoramabildern bereitstellen.

crossorigin

Gibt an, ob das Bild mit einer CORS-Anfrage abgerufen werden muss. Bilddaten eines CORS-fähigen Bildes, das über eine CORS-Anfrage zurückgegeben wurde, können im <canvas>-Element wiederverwendet werden, ohne als „tainted“ markiert zu werden.

Ist das crossorigin-Attribut nicht angegeben, wird eine Anfrage ohne CORS gesendet, also ohne den Anfrage-Header Origin. Der Browser markiert das Bild als „tainted“ und schränkt den Zugriff auf seine Bilddaten ein, sodass es nicht in <canvas>-Elementen verwendet werden kann.

Ist das crossorigin-Attribut angegeben, wird eine CORS-Anfrage mit dem Anfrage-Header Origin gesendet. Erlaubt der Server der Ursprungsseite jedoch keinen ursprungsübergreifenden Zugriff auf die Bilddaten – weil er keinen Access-Control-Allow-Origin-Antwort-Header sendet oder den Ursprung der Seite in einem solchen Header nicht aufführt –, blockiert der Browser das Laden des Bildes und protokolliert einen CORS-Fehler in der Entwicklerkonsole.

Zulässige Werte:

anonymous

Eine CORS-Anfrage wird ohne Anmeldedaten gesendet, also ohne Cookies, X.509-Zertifikate oder den Anfrage-Header Authorization.

use-credentials

Die CORS-Anfrage wird mit allen vorhandenen Anmeldedaten gesendet, also mit Cookies, X.509-Zertifikaten und dem Anfrage-Header Authorization. Erlaubt der Server die Weitergabe von Anmeldedaten an die Ursprungsseite nicht durch den Antwort-Header Access-Control-Allow-Credentials: true, markiert der Browser das Bild als „tainted“ und schränkt den Zugriff auf seine Bilddaten ein.

Hat das Attribut einen ungültigen Wert, behandeln Browser es so, als wäre anonymous angegeben. Weitere Informationen finden Sie unter CORS-Einstellungsattribute.

decoding

Dieses Attribut gibt dem Browser einen Hinweis, ob er das Bild zusammen mit dem Rendern der übrigen DOM-Inhalte in einem einzigen Darstellungsschritt dekodieren soll, sodass die Darstellung „korrekter“ wirkt (sync), oder ob er zunächst die übrigen DOM-Inhalte rendern und anzeigen und das Bild erst anschließend dekodieren und anzeigen soll (async). In der Praxis bedeutet async, dass der nächste Darstellungsschritt nicht auf die Dekodierung des Bildes wartet.

Bei statischen <img>-Elementen ist ein wahrnehmbarer Effekt von decoding oft schwer festzustellen. Während die Bilddateien aus dem Netzwerk oder Cache abgerufen werden, erscheinen sie zunächst wahrscheinlich als leere Bilder und werden anschließend ohnehin unabhängig verarbeitet. Dadurch fällt die „Synchronisierung“ der Inhaltsaktualisierungen weniger auf. Die Blockierung des Renderns während der Dekodierung lässt sich jedoch messen, auch wenn sie oft sehr kurz und mit bloßem Auge schwer zu erkennen ist. Eine ausführlichere Analyse finden Sie unter What does the image decoding attribute actually do? (tunetheweb.com, 2023).

Unterschiede zwischen den decoding-Werten können deutlicher werden, wenn <img>-Elemente mit JavaScript dynamisch in das DOM eingefügt werden. Weitere Informationen finden Sie unter HTMLImageElement.decoding.

Zulässige Werte:

sync

Das Bild synchron mit dem Rendern der übrigen DOM-Inhalte dekodieren und alles gemeinsam anzeigen.

async

Das Bild asynchron dekodieren, nachdem die übrigen DOM-Inhalte gerendert und angezeigt wurden.

auto

Keine bevorzugte Dekodierungsart; der Browser entscheidet, was für die Person am besten ist. Dies ist der Standardwert.

elementtiming

Markiert das Bild zur Beobachtung durch die PerformanceElementTiming-API. Der angegebene Wert wird zum Bezeichner des beobachteten Bildelements. Weitere Informationen finden Sie auf der Seite zum Attribut elementtiming.

fetchpriority

Gibt einen Hinweis auf die relative Priorität beim Abrufen des Bildes. Zulässige Werte:

high

Das Bild im Vergleich zu anderen Bildern mit hoher Priorität abrufen.

low

Das Bild im Vergleich zu anderen Bildern mit niedriger Priorität abrufen.

auto

Keine bevorzugte Abrufpriorität festlegen. Dies ist der Standardwert. Er wird verwendet, wenn kein oder ein ungültiger Wert angegeben ist.

height

Die intrinsische Höhe des Bildes in Pixeln. Der Wert muss eine ganze Zahl ohne Einheit sein.

Hinweis: Wenn Sie height und width angeben, kann der Browser das Seitenverhältnis des Bildes berechnen, bevor es geladen wird. Anhand dieses Seitenverhältnisses reserviert er den Platz, der für die Anzeige des Bildes benötigt wird. Dadurch wird eine Layoutverschiebung beim Herunterladen und Anzeigen des Bildes verringert oder sogar verhindert. Weniger Layoutverschiebungen sind ein wichtiger Bestandteil einer guten Benutzererfahrung und Web-Performance.

ismap

Dieses boolesche Attribut gibt an, dass das Bild Teil einer serverseitigen Image-Map ist. In diesem Fall werden die Koordinaten, auf die die Person im Bild geklickt hat, an den Server gesendet.

Hinweis: Dieses Attribut ist nur zulässig, wenn das <img>-Element ein untergeordnetes Element eines <a>-Elements mit einem gültigen href-Attribut ist. Dadurch erhalten Personen ohne Zeigegerät ein alternatives Linkziel.

loading

Gibt an, wie der Browser das Bild laden soll:

eager

Lädt das Bild sofort, unabhängig davon, ob es sich gerade im visuellen Viewport befindet. Dies ist der Standardwert.

lazy

Verschiebt das Laden des Bildes, bis es einen vom Browser berechneten Abstand zum Viewport erreicht.

Lazy Loading spart bis zu dem Zeitpunkt, an dem das Bild wahrscheinlich benötigt wird, die für seine Verarbeitung erforderliche Netzwerk- und Speicherbandbreite. Dies verbessert in den meisten typischen Anwendungsfällen die Performance.

Explizite Attribute für width und height werden für alle Bilder empfohlen, um Layoutverschiebungen zu vermeiden. Für Bilder mit Lazy Loading sind sie besonders wichtig. Solche Bilder werden nie geladen, wenn sie keinen sichtbaren Teil eines Elements schneiden – selbst wenn das Laden dies ändern würde –, da nicht geladene Bilder eine width und height von 0 haben. Wenn der im Viewport sichtbare Inhalt mitten beim Lesen neu angeordnet wird, beeinträchtigt das die Benutzererfahrung noch stärker.

Bilder mit Lazy Loading, die sich im visuellen Viewport befinden, sind möglicherweise noch nicht sichtbar, wenn das load-Ereignis von Window ausgelöst wird. Das liegt daran, dass für dieses Ereignis nur Bilder berücksichtigt werden, die sofort geladen werden. Bilder mit Lazy Loading werden selbst dann nicht berücksichtigt, wenn sie sich beim ersten Laden der Seite im visuellen Viewport befinden.

Das Laden wird nur verschoben, wenn JavaScript aktiviert ist. Dies dient dem Schutz vor Tracking: Würde ein User-Agent Lazy Loading auch bei deaktiviertem Scripting unterstützen, könnte eine Website die ungefähre Scrollposition einer Person während einer Sitzung verfolgen. Dazu müsste sie Bilder strategisch im Markup der Seite platzieren, sodass ein Server erfassen kann, wie viele Bilder wann angefordert werden.

referrerpolicy

Eine Zeichenfolge, die angibt, welcher Referrer beim Abrufen der Ressource verwendet werden soll:

  • no-referrer: Der Referer-Header wird nicht gesendet.
  • no-referrer-when-downgrade: Der Referer-Header wird nicht an Ursprünge ohne TLS (HTTPS) gesendet.
  • origin: Der gesendete Referrer ist auf den Ursprung der verweisenden Seite beschränkt: ihr Schema, ihren Host und ihren Port.
  • origin-when-cross-origin: Der an andere Ursprünge gesendete Referrer ist auf Schema, Host und Port beschränkt. Bei Navigationen innerhalb desselben Ursprungs wird weiterhin der Pfad übermittelt.
  • same-origin: Bei Anfragen an denselben Ursprung wird ein Referrer gesendet; ursprungsübergreifende Anfragen enthalten dagegen keine Referrer-Informationen.
  • strict-origin: Der Ursprung des Dokuments wird nur dann als Referrer gesendet, wenn das Sicherheitsniveau des Protokolls gleich bleibt (HTTPS→HTTPS), nicht aber an ein weniger sicheres Ziel (HTTPS→HTTP).
  • strict-origin-when-cross-origin (Standardwert): Bei einer Anfrage an denselben Ursprung wird die vollständige URL gesendet. Bleibt das Sicherheitsniveau des Protokolls gleich (HTTPS→HTTPS), wird bei ursprungsübergreifenden Anfragen nur der Ursprung gesendet. An ein weniger sicheres Ziel (HTTPS→HTTP) wird kein Header gesendet.
  • unsafe-url: Der Referrer enthält den Ursprung und den Pfad, aber nicht das Fragment, das Passwort oder den Benutzernamen. Dieser Wert ist unsicher, da er Ursprünge und Pfade TLS-geschützter Ressourcen an unsichere Ursprünge weitergibt.
sizes

Ein oder mehrere durch Kommas getrennte Werte, bei denen es sich um Quellgrößen oder das Schlüsselwort auto handeln kann. Laut Spezifikation darf das sizes-Attribut nur vorhanden sein, wenn srcset Breiten-Deskriptoren verwendet.

Quellgröße

Eine Quellgröße besteht aus:

  1. Einer Medienbedingung, die beim letzten Eintrag der Liste weggelassen wird.
  2. Einem Quellgrößenwert.

Die folgende Quellgröße schlägt beispielsweise vor, eine 1000px breite Bildquelle zu verwenden, wenn der Viewport höchstens 500px breit ist.

css
(width <= 500px) 1000px

Medienbedingungen beschreiben Eigenschaften des Viewports, nicht des Bildes. Da ein Quellgrößen-Deskriptor angibt, welche Breite für das Bild beim Layout verwendet werden soll, basiert die Medienbedingung üblicherweise – aber nicht zwingend – auf width.

Quellgrößenwerte geben die beabsichtigte Anzeigegröße des Bildes an. User-Agents verwenden die aktuelle Quellgröße, um eine der im srcset-Attribut angegebenen Quellen auszuwählen, wenn diese mit Breiten-Deskriptoren (w) beschrieben sind. Der in sizes definierte w-Wert bestimmt die Standardbreite des Bildes im Layout. Ohne CSS rendert der Browser das Bild in dieser Größe, unabhängig von den tatsächlichen Pixelabmessungen der heruntergeladenen Datei.

Ein Quellgrößenwert kann eine beliebige nicht negative Länge sein. Er darf außer mathematischen Funktionen keine CSS-Funktionen verwenden. Einheiten werden wie bei Media Queries interpretiert: Alle relativen Längeneinheiten beziehen sich auf das Wurzelelement des Dokuments und nicht auf das <img>-Element. Ein em-Wert bezieht sich beispielsweise auf die Schriftgröße des Wurzelelements, nicht auf die Schriftgröße des Bildes. Prozentwerte sind nicht zulässig. Fehlt das sizes-Attribut, gilt der Standardwert 100vw (die Breite des Viewports).

auto

Das Schlüsselwort auto gibt an, dass der Browser die erwartete Layoutbreite des Elements zur Auswahl des anzuzeigenden Bildes verwenden soll. Er verwendet dafür die konkrete Größe des Bildes, die nach Anwendung des HTML- und CSS-Layouts berechnet wird. Dies ist nur in Kombination mit loading="lazy" gültig, da CSS und andere Layoutinformationen beim Laden des Bildes voraussichtlich bereits vorliegen.

Mit auto müssen Sie Ihre Medienbedingungen für das Layout nicht zweimal angeben: einmal für das Layout und ein weiteres Mal für die Auswahl eines geeigneten Bildes zum Abrufen und Anzeigen.

Kann auto nicht aufgelöst werden – weil der Browser es nicht unterstützt oder weil das Bild noch keine Layoutgröße hat –, greift der Browser zunächst auf die Quellgrößen in der Liste zurück, um die Breite zu bestimmen. Danach verwendet er die am Element definierten Attribute width und height und schließlich die im User-Agent-Stylesheet festgelegte intrinsische Standardgröße für <img>-Elemente (300px × 150px).

Für eine bessere Abwärtskompatibilität mit Browsern, die auto nicht unterstützen, können Sie im sizes-Attribut nach auto Ersatzgrößen angeben. Setzen Sie außerdem die Attribute width und height des Elements auf die intrinsischen Abmessungen des größten Bildes in Ihrem srcset, damit der Browser Platz mit dem richtigen Seitenverhältnis reservieren kann:

html
<img
  loading="lazy"
  width="200"
  height="200"
  sizes="auto, (max-width: 30em) 100vw, (max-width: 50em) 50vw, calc(33vw - 100px)"
  srcset="swing-200.jpg   200w, swing-400.jpg   400w, swing-800.jpg   800w, swing-1600.jpg 1600w"
  src="swing-400.jpg"
  alt="Kettlebell Swing" />
src

Die URL des Bildes. Für ein <img>-Element muss mindestens eines der Attribute src und srcset angegeben werden. Wenn srcset angegeben ist, wird src auf eine von zwei Arten verwendet:

  • Als Ersatz für Browser, die srcset nicht unterstützen.
  • Wenn srcset den „x“-Deskriptor verwendet, entspricht src einer Quelle mit dem Pixeldichte-Deskriptor 1x. Das durch src angegebene Bild wird dann auf Bildschirmen mit geringer Pixeldichte verwendet, beispielsweise auf typischen Anzeigen mit 72 DPI oder 96 DPI.
srcset

Eine oder mehrere durch Kommas getrennte Zeichenfolgen, die mögliche Bildquellen für den User-Agent angeben.

Jede Zeichenfolge besteht aus:

  1. Einer URL zu einem Bild
  2. Optional einem Leerraumzeichen, gefolgt von einem der folgenden Deskriptoren:
    • Einem Breiten-Deskriptor (einer positiven ganzen Zahl, auf die unmittelbar w folgt). Er muss mit der intrinsischen Breite des referenzierten Bildes übereinstimmen. Der Breiten-Deskriptor wird durch die im sizes-Attribut angegebene Quellgröße geteilt, um die effektive Pixeldichte zu berechnen. Wenn Sie beispielsweise eine Bildressource für eine benötigte Bildbreite von 450 Pixeln bereitstellen möchten, verwenden Sie den Breiten-Deskriptor 450w. Enthält srcset „w“-Deskriptoren, verwendet der Browser diese zusammen mit dem sizes-Attribut zur Auswahl einer Ressource.
    • Einem Pixeldichte-Deskriptor (einer positiven Gleitkommazahl, auf die unmittelbar x folgt). Er gibt an, bei welcher Pixeldichte des Bildschirms die entsprechende Bildressource verwendet werden soll. Wenn Sie beispielsweise eine Bildressource für die doppelte Standardpixeldichte bereitstellen möchten, verwenden Sie den Pixeldichte-Deskriptor 2x oder 2.0x.

Ist kein Deskriptor angegeben, erhält die Quelle den Standard-Deskriptor 1x. Breiten- und Pixeldichte-Deskriptoren dürfen nicht im selben srcset-Attribut gemischt werden. Doppelte Deskriptoren sind ebenfalls ungültig, beispielsweise zwei Quellen im selben srcset, die beide mit 2x beschrieben sind.

Leerraumzeichen werden ignoriert, außer wenn sie die URL vom zugehörigen Deskriptor trennen. Das gilt auch für Leerraum am Anfang und Ende sowie vor oder nach jedem Komma. Enthält eine Zeichenfolge für einen Bildkandidaten jedoch weder einen Deskriptor noch Leerraum nach der URL, muss die nächste Zeichenfolge für einen Bildkandidaten, sofern vorhanden, mit mindestens einem Leerraumzeichen beginnen. Andernfalls wird das Komma als Teil der URL betrachtet.

Wenn srcset beim <img>-Element x-Deskriptoren verwendet, berücksichtigen Browser auch die URL im src-Attribut, sofern vorhanden, als Kandidaten und weisen ihr den Standard-Deskriptor 1x zu. Verwendet das srcset-Attribut dagegen Breiten-Deskriptoren, wird src nicht berücksichtigt; stattdessen wird das sizes-Attribut verwendet.

Der User-Agent wählt nach eigenem Ermessen eine der verfügbaren Quellen aus. Dadurch hat er erheblichen Spielraum, um die Auswahl beispielsweise an Benutzereinstellungen oder die verfügbare Bandbreite anzupassen. Ein Beispiel finden Sie in unserem Tutorial zu responsiven Bildern.

width

Die intrinsische Breite des Bildes in Pixeln. Der Wert muss eine ganze Zahl ohne Einheit sein.

usemap

Die Teil-URL, die mit # beginnt, einer dem Element zugeordneten Image-Map.

Hinweis: Sie können dieses Attribut nicht verwenden, wenn sich das <img>-Element innerhalb eines <a>- oder <button>-Elements befindet.

Veraltete Attribute

align

Richtet das Bild an seinem umgebenden Kontext aus. Verwenden Sie statt dieses Attributs die CSS-Eigenschaften float und/oder vertical-align. Zulässige Werte:

top

Entspricht vertical-align: top oder vertical-align: text-top

middle

Entspricht vertical-align: -moz-middle-with-baseline

bottom

Der Standardwert; entspricht vertical-align: unset oder vertical-align: initial

left

Entspricht float: left

Entspricht float: right

border

Die Breite eines Rahmens um das Bild. Verwenden Sie stattdessen die CSS-Eigenschaft border.

hspace

Die Anzahl der Pixel Leerraum links und rechts vom Bild. Verwenden Sie stattdessen die CSS-Eigenschaft margin.

longdesc

Ein Link zu einer ausführlicheren Beschreibung des Bildes. Mögliche Werte sind eine URL oder die id eines Elements.

Hinweis: Dieses Attribut gilt laut HTML-Spezifikation als überholt. Seine Zukunft ist ungewiss; verwenden Sie stattdessen eine WAI-ARIA-Alternative wie aria-describedby oder aria-details.

name

Ein Name für das Element. Verwenden Sie stattdessen das Attribut id.

vspace

Die Anzahl der Pixel Leerraum oberhalb und unterhalb des Bildes. Verwenden Sie stattdessen die CSS-Eigenschaft margin.

Verwendungshinweise

Jedes <img>-Element benötigt mindestens zwei Attribute. Meist sind dies src und alt.

  • Das src-Attribut enthält den Pfad zum Bild, das Sie einbetten möchten. Es ist nicht erforderlich, wenn das Attribut srcset vorhanden ist. Mindestens eines der Attribute src oder srcset muss jedoch angegeben werden.
  • Das alt-Attribut enthält einen Textersatz für das Bild. Es ist erforderlich und für die Barrierefreiheit außerordentlich wichtig: Screenreader lesen den Attributwert vor, damit ihre Nutzer verstehen, was das Bild bedeutet. Alternativtext wird auch auf der Seite angezeigt, wenn das Bild aus irgendeinem Grund nicht geladen werden kann, beispielsweise wegen Netzwerkfehlern, Inhaltssperren oder eines nicht mehr funktionierenden Links.

Für unterschiedliche Zwecke stehen viele weitere Attribute zur Verfügung:

Der Leitfaden zu Bilddateitypen und -formaten enthält Informationen über unterstützte Bildformate und allgemeine Empfehlungen zu ihrer Verwendung.

Fehler beim Laden von Bildern

Tritt beim Laden oder Rendern eines Bildes ein Fehler auf und wurde für das error-Ereignis ein onerror-Event-Handler festgelegt, wird dieser aufgerufen. Das kann unter anderem in folgenden Situationen passieren:

  • Die Attribute src oder srcset sind leer ("") oder null.
  • Die src-URL stimmt mit der URL der Seite überein, auf der sich die Person gerade befindet.
  • Das Bild ist so beschädigt, dass es nicht geladen werden kann.
  • Die Metadaten des Bildes sind so beschädigt, dass seine Abmessungen nicht ermittelt werden können, und in den Attributen des <img>-Elements wurden keine Abmessungen angegeben.
  • Das Bild liegt in einem Format vor, das der User-Agent nicht unterstützt.

Gestaltung mit CSS

<img> ist ein ersetztes Element. Sein display-Wert ist standardmäßig inline, seine Standardabmessungen werden jedoch durch die intrinsischen Werte des eingebetteten Bildes bestimmt, ähnlich wie bei inline-block. Sie können für ein Bild Eigenschaften wie border/border-radius, padding/margin, width und height festlegen.

<img> hat keine Grundlinie. Werden Bilder in einem Inline-Formatierungskontext mit vertical-align: baseline verwendet, wird daher die Unterkante des Bildes auf der Textgrundlinie platziert.

Mit der Eigenschaft object-position können Sie das Bild innerhalb der Box des Elements positionieren. Mit object-fit können Sie seine Größe innerhalb der Box anpassen, beispielsweise festlegen, ob es in die Box passen oder sie auch dann ausfüllen soll, wenn es dafür beschnitten werden muss.

Abhängig vom Bildtyp kann ein Bild eine intrinsische Breite und Höhe haben. Bei manchen Bildtypen sind intrinsische Abmessungen jedoch nicht erforderlich. SVG-Bilder haben beispielsweise keine intrinsischen Abmessungen, wenn für ihr <svg>-Wurzelelement weder width noch height festgelegt ist.

Barrierefreiheit

Aussagekräftige Alternativbeschreibungen verfassen

Der Wert eines alt-Attributs sollte den Bildinhalt klar und knapp als Text wiedergeben. Er sollte weder beschreiben, dass ein Bild vorhanden ist, noch den Dateinamen des Bildes nennen. Wenn Sie das alt-Attribut bewusst weglassen, weil das Bild keine textliche Entsprechung hat, sollten Sie andere Möglichkeiten in Betracht ziehen, seine Aussage zu vermitteln.

Nicht so

html
<img alt="image" src="penguin.jpg" />

So

html
<img alt="A Penguin on a beach." src="penguin.jpg" />

Ein wichtiger Test für die Barrierefreiheit besteht darin, den Inhalt des alt-Attributs zusammen mit dem vorangehenden Text zu lesen und zu prüfen, ob er dieselbe Bedeutung wie das Bild vermittelt. Wenn vor dem Bild beispielsweise der Satz „Auf meinen Reisen sah ich ein niedliches kleines Tier:“ steht, könnte ein Screenreader das Beispiel unter Nicht so als „Auf meinen Reisen sah ich ein niedliches kleines Tier: Bild“ vorlesen. Das ist nicht aussagekräftig. Das Beispiel unter So könnte er als „Auf meinen Reisen sah ich ein niedliches kleines Tier: Ein Pinguin am Strand.“ vorlesen. Das ist verständlich.

Bei Bildern, die eine Aktion auslösen, beispielsweise innerhalb eines <a>- oder <button>-Elements, sollte der Wert des alt-Attributs die ausgelöste Aktion beschreiben. So könnten Sie alt="next page" statt alt="arrow right" schreiben. Sie können auch eine zusätzliche, optionale Beschreibung im title-Attribut angeben. Screenreader lesen diese gegebenenfalls auf Wunsch der Person vor.

Wenn ein Bild kein alt-Attribut hat, geben manche Screenreader stattdessen möglicherweise den Dateinamen des Bildes aus. Ist der Dateiname nicht aussagekräftig für den Bildinhalt, kann das verwirrend sein.

SVG als Bild kennzeichnen

Aufgrund eines VoiceOver-Fehlers kündigt VoiceOver SVG-Bilder nicht korrekt als Bilder an. Fügen Sie bei allen <img>-Elementen mit SVG-Quelldateien role="img" hinzu, damit assistive Technologien den SVG-Inhalt korrekt als Bild ankündigen.

html
<img src="mdn.svg" alt="MDN" role="img" />

Das title-Attribut

Das Attribut title ist kein geeigneter Ersatz für das alt-Attribut. Vermeiden Sie außerdem, den Wert des alt-Attributs in einem title-Attribut desselben Bildes zu wiederholen. Andernfalls lesen manche Screenreader denselben Text möglicherweise zweimal vor, was verwirrend sein kann.

Das title-Attribut sollte auch nicht verwendet werden, um die alt-Beschreibung eines Bildes um Informationen einer Bildunterschrift zu ergänzen. Wenn ein Bild eine Bildunterschrift benötigt, verwenden Sie die Elemente figure und figcaption.

Der Wert des title-Attributs wird üblicherweise als Tooltip angezeigt, kurz nachdem der Mauszeiger auf dem Bild stehen geblieben ist. Das kann zusätzliche Informationen liefern. Gehen Sie jedoch nicht davon aus, dass alle Personen den Tooltip sehen: Manche verwenden ausschließlich eine Tastatur oder einen Touchscreen. Besonders wichtige oder nützliche Informationen sollten Sie daher mit einer der oben genannten Methoden direkt im Inhalt bereitstellen, statt title zu verwenden.

Beispiele

Alternativtext

Das folgende Beispiel bettet ein Bild in die Seite ein und enthält Alternativtext für die Barrierefreiheit.

html
<img src="/p/https://developer.mozilla.org/shared-assets/images/examples/favicon144.png" alt="MDN" />

Dieses Beispiel baut auf dem vorherigen auf und zeigt, wie Sie aus dem Bild einen Link machen. Dazu verschachteln Sie das <img>-Tag im <a>-Element. Der Alternativtext sollte die Ressource beschreiben, auf die der Link verweist – so, als würden Sie stattdessen einen Textlink verwenden.

html

Das srcset-Attribut verwenden

In diesem Beispiel verwenden wir ein srcset-Attribut mit einem Verweis auf eine hochauflösende Version des Logos. Auf hochauflösenden Geräten wird diese anstelle des über src angegebenen Bildes geladen. Das im src-Attribut referenzierte Bild gilt bei User-Agents, die srcset unterstützen, als 1x-Kandidat.

html
<img
  src="/p/https://developer.mozilla.org/shared-assets/images/examples/favicon72.png"
  alt="MDN"
  srcset="/p/https://developer.mozilla.org/shared-assets/images/examples/favicon144.png 2x" />

Die Attribute srcset und sizes verwenden

Das src-Attribut wird von User-Agents, die srcset unterstützen, ignoriert, wenn w-Deskriptoren angegeben sind. Wenn die Medienbedingung (width <= 600px) zutrifft, wird das 200 Pixel breite Bild geladen, da es 200px am nächsten kommt. Andernfalls wird das andere Bild geladen.

html
<img
  src="clock-demo-200px.png"
  alt="The time is 12:45."
  srcset="clock-demo-200px.png 200w, clock-demo-400px.png 400w"
  sizes="(width <= 600px) 200px, 50vw" />

Hinweis: Um zu sehen, wie sich die Größenänderung auswirkt, öffnen Sie das Beispiel auf einer separaten Seite. Dort können Sie die Größe des Inhaltsbereichs tatsächlich ändern.

Sicherheits- und Datenschutzaspekte

Obwohl <img>-Elemente für unbedenkliche Zwecke eingesetzt werden, können sie unerwünschte Folgen für die Sicherheit und Privatsphäre der Nutzer haben. Weitere Informationen und Gegenmaßnahmen finden Sie unter Referer-Header: Datenschutz- und Sicherheitsaspekte.

Technische Zusammenfassung

Inhaltskategorien Flussinhalt, formulierender Inhalt, eingebetteter Inhalt, wahrnehmbarer Inhalt. Hat das Element ein usemap-Attribut, gehört es auch zur Kategorie der interaktiven Inhalte.
Erlaubter Inhalt Keiner; es ist ein leeres Element.
Auslassen von Tags Muss ein Start-Tag haben und darf kein End-Tag haben.
Erlaubte Elternelemente Jedes Element, das eingebetteten Inhalt akzeptiert.
Implizite ARIA-Rolle
  • mit nicht leerem alt-Attribut oder ohne alt-Attribut: img
  • mit leerem alt-Attribut: presentation
Erlaubte ARIA-Rollen
DOM-Schnittstelle [`HTMLImageElement`](/de/docs/Web/API/HTMLImageElement)

Spezifikationen

Spezifikation
HTML
# the-img-element

Browser-Kompatibilität

Siehe auch

⌂ 换网址