<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üraltan.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 dasalt-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- oderAttribution-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 desAttribution-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 derAttribution-Reporting-Eligible-Header an denselben Server gesendet wird, auf den dassrc-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
attributionsrceine oder mehrere URLs angeben. Bei der Ressourcenanfrage wird derAttribution-Reporting-Eligible-Header zusätzlich zum Ursprungsserver der Ressource an die inattributionSrcangegebenen URLs gesendet. Diese URLs können mit einemAttribution-Reporting-Register-Source- oderAttribution-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.
- Als boolesches Attribut, also nur mit dem Namen
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-HeaderOrigin. 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-HeaderOrigingesendet. Erlaubt der Server der Ursprungsseite jedoch keinen ursprungsübergreifenden Zugriff auf die Bilddaten – weil er keinenAccess-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-HeaderAccess-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
anonymousangegeben. 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 bedeutetasync, dass der nächste Darstellungsschritt nicht auf die Dekodierung des Bildes wartet.Bei statischen
<img>-Elementen ist ein wahrnehmbarer Effekt vondecodingoft 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 unterHTMLImageElement.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 Attributelementtiming. fetchpriority-
Gibt einen Hinweis auf die relative Priorität beim Abrufen des Bildes. Zulässige Werte:
height-
Die intrinsische Höhe des Bildes in Pixeln. Der Wert muss eine ganze Zahl ohne Einheit sein.
Hinweis: Wenn Sie
heightundwidthangeben, 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.
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
widthundheightwerden 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 einewidthundheightvon0haben. 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: DerReferer-Header wird nicht gesendet.no-referrer-when-downgrade: DerReferer-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
autohandeln kann. Laut Spezifikation darf dassizes-Attribut nur vorhanden sein, wennsrcsetBreiten-Deskriptoren verwendet.- Quellgröße
-
Eine Quellgröße besteht aus:
- Einer Medienbedingung, die beim letzten Eintrag der Liste weggelassen wird.
- Einem Quellgrößenwert.
Die folgende Quellgröße schlägt beispielsweise vor, eine
1000pxbreite Bildquelle zu verwenden, wenn der Viewport höchstens 500px breit ist.css(width <= 500px) 1000pxMedienbedingungen 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 insizesdefiniertew-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. Einem-Wert bezieht sich beispielsweise auf die Schriftgröße des Wurzelelements, nicht auf die Schriftgröße des Bildes. Prozentwerte sind nicht zulässig. Fehlt dassizes-Attribut, gilt der Standardwert100vw(die Breite des Viewports). auto-
Das Schlüsselwort
autogibt 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 mitloading="lazy"gültig, da CSS und andere Layoutinformationen beim Laden des Bildes voraussichtlich bereits vorliegen.Mit
automü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
autonicht 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 Attributewidthundheightund 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
autonicht unterstützen, können Sie imsizes-Attribut nachautoErsatzgrößen angeben. Setzen Sie außerdem die Attributewidthundheightdes Elements auf die intrinsischen Abmessungen des größten Bildes in Ihremsrcset, 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 Attributesrcundsrcsetangegeben werden. Wennsrcsetangegeben ist, wirdsrcauf eine von zwei Arten verwendet:- Als Ersatz für Browser, die
srcsetnicht unterstützen. - Wenn
srcsetden „x“-Deskriptor verwendet, entsprichtsrceiner Quelle mit dem Pixeldichte-Deskriptor1x. Das durchsrcangegebene Bild wird dann auf Bildschirmen mit geringer Pixeldichte verwendet, beispielsweise auf typischen Anzeigen mit 72 DPI oder 96 DPI.
- Als Ersatz für Browser, die
srcset-
Eine oder mehrere durch Kommas getrennte Zeichenfolgen, die mögliche Bildquellen für den User-Agent angeben.
Jede Zeichenfolge besteht aus:
- Einer URL zu einem Bild
- Optional einem Leerraumzeichen, gefolgt von einem der folgenden Deskriptoren:
- Einem Breiten-Deskriptor (einer positiven ganzen Zahl, auf die unmittelbar
wfolgt). Er muss mit der intrinsischen Breite des referenzierten Bildes übereinstimmen. Der Breiten-Deskriptor wird durch die imsizes-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-Deskriptor450w. Enthältsrcset„w“-Deskriptoren, verwendet der Browser diese zusammen mit demsizes-Attribut zur Auswahl einer Ressource. - Einem Pixeldichte-Deskriptor (einer positiven Gleitkommazahl, auf die unmittelbar
xfolgt). 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-Deskriptor2xoder2.0x.
- Einem Breiten-Deskriptor (einer positiven ganzen Zahl, auf die unmittelbar
Ist kein Deskriptor angegeben, erhält die Quelle den Standard-Deskriptor
1x. Breiten- und Pixeldichte-Deskriptoren dürfen nicht im selbensrcset-Attribut gemischt werden. Doppelte Deskriptoren sind ebenfalls ungültig, beispielsweise zwei Quellen im selbensrcset, die beide mit2xbeschrieben 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
srcsetbeim<img>-Elementx-Deskriptoren verwendet, berücksichtigen Browser auch die URL imsrc-Attribut, sofern vorhanden, als Kandidaten und weisen ihr den Standard-Deskriptor1xzu. Verwendet dassrcset-Attribut dagegen Breiten-Deskriptoren, wirdsrcnicht berücksichtigt; stattdessen wird dassizes-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.
Veraltete Attribute
align-
Richtet das Bild an seinem umgebenden Kontext aus. Verwenden Sie statt dieses Attributs die CSS-Eigenschaften
floatund/odervertical-align. Zulässige Werte: 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
ideines Elements.Hinweis: Dieses Attribut gilt laut HTML-Spezifikation als überholt. Seine Zukunft ist ungewiss; verwenden Sie stattdessen eine WAI-ARIA-Alternative wie
aria-describedbyoderaria-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 Attributesrcodersrcsetmuss 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:
- Steuerung von Referrer und CORS für Sicherheit und Datenschutz: siehe
crossoriginundreferrerpolicy. - Verwenden Sie sowohl
widthals auchheight, um die intrinsische Größe des Bildes festzulegen. So kann es bereits vor dem Laden Platz einnehmen, was Layoutverschiebungen verringert. - Hinweise für responsive Bilder mit
sizesundsrcset(siehe auch das<picture>-Element und unser Tutorial zu responsiven Bildern).
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
srcodersrcsetsind leer ("") odernull. - 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
<img alt="image" src="penguin.jpg" />
So
<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.
- Entscheidungsbaum für Alternativtexte • Bilder • WAI-Tutorials zur Barrierefreiheit im Web
- Alternativtexte: Der ultimative Leitfaden — Axess Lab
- Gute Alternativtexte gestalten: Eine Einführung | Deque
- MDN: WCAG verstehen, Erläuterungen zu Richtlinie 1.1
- Erfolgskriterium 1.1.1 verstehen | W3C: WCAG 2.0 verstehen
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.
<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.
<img src="/p/https://developer.mozilla.org/shared-assets/images/examples/favicon144.png" alt="MDN" />
Bild als Link
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.
<a href="/p/https://developer.mozilla.org">
<img
src="/p/https://developer.mozilla.org/shared-assets/images/examples/favicon144.png"
alt="Visit the MDN site" />
</a>
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.
<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.
<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 |
|
| Erlaubte ARIA-Rollen |
|
| DOM-Schnittstelle | [`HTMLImageElement`](/de/docs/Web/API/HTMLImageElement) |
Spezifikationen
| Spezifikation |
|---|
| HTML> # the-img-element> |
Browser-Kompatibilität
Siehe auch
- Die Elemente
<picture>,<object>und<embed> object-fit,object-position,image-orientation,image-renderingundimage-resolution: CSS-Eigenschaften für Bilder- Die Schnittstelle
HTMLImageElementfür dieses Element - HTML-Bilder
- Leitfaden zu Bilddateitypen und -formaten
- Responsive Bilder