Alt-Attribut (Alt-Tag) in HTML: Syntax, leeres alt und typische Fehler

Einzelne Buchstaben liegen verstreut auf dem Boden. Foto: Amador Loureiro auf Unsplash.

Lesezeit: 29 Minuten

Der Alt-Tag ist streng genommen kein Tag, sondern ein Attribut: alt am img-Element. Es enthält den Text, der das Bild ersetzt, wenn es nicht angezeigt oder nicht gesehen werden kann. Der HTML-Standard verlangt das Attribut grundsätzlich an jedem img. Bei inhaltlichen Bildern steht darin ein Ersatztext, bei dekorativen Bildern bleibt es leer (alt=""). Fehlen darf es nur in eng begrenzten Ausnahmen. Dieser Beitrag zeigt die Syntax, die drei Zustände des Attributs, die Sonderfälle picture, figure, svg, input type="image" und CSS-Hintergründe sowie Wege, Fehler im Code zu finden. Stand: November 2026.

Das Wichtigste in Kürze

  • „Alt-Tag“, „Alt-Attribut“ und „Alternativtext“ meinen im Alltag dasselbe. Korrekt ist: alt ist ein Attribut, der Alternativtext ist sein Wert.
  • Ein img kennt drei Zustände: alt mit Text, alt="" und fehlendes alt. Der HTML-Standard gibt jedem eine eigene Bedeutung.
  • alt="" ist kein Fehler, sondern die korrekte Auszeichnung für dekorative Bilder. Ein fehlendes alt ist etwas anderes: Manche Screenreader lesen dann den Dateinamen vor.
  • Bei picture gehört das alt an das innere img, nicht an picture oder source.
  • Bei input type="image" ist ein nicht leeres alt Pflicht. Inline-SVG und CSS-Hintergrundbilder haben gar kein alt und brauchen andere Mittel.
  • Fehlende Attribute findest du mit einem Selektor in der Browser-Konsole, einem HTML-Validator und einer Lint-Regel im Build.

Alt-Tag, Alt-Attribut, Alternativtext: die Begriffe

In HTML ist ein Tag die Schreibweise eines Elements in spitzen Klammern, etwa das Start-Tag von img. Ein Attribut steht innerhalb dieses Tags und besteht aus Name und Wert. alt ist ein solches Attribut. Der HTML-Standard führt es in der Attributliste des img-Elements als Ersatztext für den Fall, dass Bilder nicht verfügbar sind.

BegriffWas gemeint istTechnisch korrekt?
Alt-TagUmgangssprachlich für das alt-AttributNein, es gibt kein Element namens alt
Alt-AttributDas Attribut alt an img, area und input type="image"Ja
Alt-Text, AlternativtextDer Wert des Attributs, also der Ersatztext selbstJa
Title-TagMeist das title-Attribut oder das title-Element der SeiteHat mit alt nichts zu tun

Wie sich alt, title und Bildunterschrift unterscheiden, steht im Beitrag Bildunterschrift, Alt-Text und Title-Attribut. Hier geht es um den Code.

Die Syntax des Alt-Attributs

Die Grundform ist ein Attribut mit Wert in doppelten Anführungszeichen:

<img src="werkhalle.jpg" alt="Werkhalle mit drei Spritzgussmaschinen in einer Reihe" width="1200" height="800">

Für den Wert gelten die allgemeinen Syntaxregeln für HTML-Attribute:

  • Der Wert ist reiner Text. HTML-Elemente im Wert werden nicht ausgewertet. Zeichenreferenzen wie &amp; sind erlaubt.
  • Anführungszeichen maskieren. In einem Wert mit doppelten Anführungszeichen darf kein wörtliches doppeltes Anführungszeichen stehen. Schreib stattdessen &quot; oder verwende typografische Anführungszeichen.
  • Ohne Anführungszeichen geht es nur ohne Leerzeichen. Die Schreibweise ohne Anführungszeichen erlaubt keine Leerzeichen im Wert. Für Alt-Texte ist sie deshalb praktisch unbrauchbar.
  • Der Attributname ist in HTML nicht case-sensitiv. ALT funktioniert, üblich ist die Kleinschreibung.
  • Nur der Attributname ohne Wert bedeutet leerer String. Laut Standard ist der Wert dann implizit die leere Zeichenkette. alt ohne Wert ist in HTML also dasselbe wie alt="".
<!-- Anführungszeichen im Wert maskieren -->
<img src="schild.jpg" alt="Türschild mit der Aufschrift &quot;Bitte klingeln&quot;">

<!-- Kaufmännisches Und als Zeichenreferenz -->
<img src="logo-mk.svg" alt="Müller &amp; Kraus Metallbau">

<!-- Beide Zeilen sind gleichbedeutend: leeres alt -->
<img src="wellenlinie.svg" alt="">
<img src="wellenlinie.svg" alt>

Empfehlung für Teams: Schreibt das leere Attribut immer als alt="" aus. So ist im Review erkennbar, dass die Entscheidung bewusst getroffen wurde. In JSX ist das zwingend. Die Lint-Regel alt-text von eslint-plugin-jsx-a11y meldet ein alt ohne Wert als Fehler.

Drei Zustände: alt mit Text, leeres alt, fehlendes alt

Der HTML-Standard legt fest, was ein img mit gesetztem src je nach Zustand des Attributs bedeutet. Das ist die wichtigste Tabelle dieses Beitrags:

CodeBedeutung laut HTML-StandardFolge für ScreenreaderZulässig?
alt="Text"Das Bild ist ein wesentlicher Teil des Inhalts. Der Wert ist das textliche Äquivalent.Der Text wird anstelle des Bildes ausgegeben.Ja, Normalfall für inhaltliche Bilder
alt=""Das Bild ist dekorativ oder ergänzt nur den übrigen Inhalt.Hilfsmittel können das Bild ignorieren.Ja, Normalfall für dekorative Bilder
kein altDas Bild ist möglicherweise ein wesentlicher Teil des Inhalts, und es gibt kein textliches Äquivalent.Manche Screenreader lesen stattdessen den Dateinamen vor.Nur in eng begrenzten Ausnahmen

Die Grundregel steht in den Anforderungen des Standards an Alternativtexte: Sofern nichts anderes bestimmt ist, muss das alt-Attribut angegeben sein, und sein Wert darf nicht leer sein. Die Fälle, in denen es leer sein muss, nennt der Standard einzeln. Dass ein fehlendes Attribut bei Screenreadern zum Dateinamen führen kann, beschreiben das W3C-Tutorial zu dekorativen Bildern und die MDN-Referenz zu img. Wie sich das anhört, erklärt unser Beitrag Screenreader: wie sie Websites und Bilder vorlesen.

Im Browser hat der Unterschied ebenfalls Folgen. Laut MDN zeigt der Browser den Alt-Text an, wenn ein Bild nicht geladen werden kann. Ist das alt leer, blenden visuelle Browser auch das Symbol für das defekte Bild aus. Der Wert wird außerdem verwendet, wenn Nutzer das Bild als Text kopieren oder ein verlinktes Bild als Lesezeichen speichern.

Wann ein fehlendes alt kein Validierungsfehler ist

Der Standard schreibt Prüfwerkzeugen vor, ein fehlendes alt als Fehler zu melden. Er nennt vier Ausnahmen: Das Bild steht in einer figure mit figcaption, die die dort genannten Bedingungen erfüllt. Das img hat ein nicht leeres title-Attribut. Der Prüfer ist auf E‑Mails oder Dokumente für einen bekannten Empfänger eingestellt. Oder das img trägt das Attribut generator-unable-to-provide-required-alt mit leerem Wert.

Das letzte Attribut ist für Software gedacht, die Markup erzeugt und für ein Bild keinen Text beschaffen kann. Der Standard stuft es selbst als nicht konform ein. Prüfer müssen den Fehler dann nicht anzeigen, dürfen es aber. Für deine eigenen Templates sind diese Ausnahmen kein Freibrief. Sie verhindern eine Fehlermeldung, das Bild bleibt für Menschen ohne Sicht trotzdem ohne Ersatztext. Unsere Empfehlung: Behandle jedes img ohne alt als Fehler.

Leeres alt richtig einsetzen

Der Standard verlangt in mehreren Fällen ausdrücklich ein vorhandenes, aber leeres Attribut:

  • Rein dekorative Bilder, die keine Information hinzufügen.
  • Icons neben einem Text, der dasselbe sagt. Das Icon wiederholt dann nur die Beschriftung.
  • Bildgruppen, die zusammen ein Bild ergeben. Ein Bild der Gruppe bekommt den Alt-Text für das Ganze, alle übrigen bekommen alt="".
  • Bilder, die nicht für Nutzer bestimmt sind, etwa Zählpixel. Der Standard rät allerdings generell davon ab, img für etwas anderes als Bilder zu verwenden.
<!-- Icon neben Text: Der Linktext trägt die Bedeutung -->
<a href="/kontakt">
  <img src="brief.svg" alt="" width="16" height="16">
  Kontakt aufnehmen
</a>

<!-- Bewertung aus fünf Einzelbildern: ein alt für die Gruppe -->
<p>
  <img src="stern-voll.svg" alt="Bewertung: 4 von 5 Sternen">
  <img src="stern-voll.svg" alt="">
  <img src="stern-voll.svg" alt="">
  <img src="stern-voll.svg" alt="">
  <img src="stern-leer.svg" alt="">
</p>

alt=””, role=“presentation” oder aria-hidden?

Für dekorative img-Elemente reicht alt="". Das Attribut ändert bereits die Rolle: Die W3C-Empfehlung ARIA in HTML ordnet einem img mit leerem alt die implizite Rolle none beziehungsweise presentation zu. Ein zusätzliches role="presentation" ist dort als nicht empfohlen markiert, weil es nur wiederholt, was schon gilt. Das W3C-Tutorial ergänzt, dass role="presentation" weniger breit unterstützt wird als das leere alt.

MittelWirkungEinsatz bei Bildern
alt=""Kennzeichnet das img als dekorativ. Implizite Rolle none/presentation.Standard für dekorative img
role="presentation" oder role="none"Entfernt laut MDN die Semantik des Elements, der Inhalt bleibt erreichbar. Browser ignorieren die Rolle an fokussierbaren Elementen und bei gesetzten globalen ARIA-Attributen.Am img überflüssig. Ersetzt kein fehlendes alt im Sinne des HTML-Standards.
aria-hidden="true"Entfernt laut MDN das Element samt Kindern aus dem Accessibility Tree.Für dekorative Inline-SVGs und Icon-Fonts. Nie an fokussierbaren Elementen.

Zwei Kombinationen sind fehlerhaft. Erstens ein nicht leeres alt zusammen mit role="presentation": ARIA in HTML erlaubt die Rollen none und presentation nur an Bildern mit leerem oder fehlendem alt, und Autoren dürfen ARIA nicht so einsetzen, dass es der Semantik des Elements widerspricht. Zweitens ein leeres alt mit title: Die WCAG-Technik H67 verlangt für Bilder, die ignoriert werden sollen, ein leeres alt und kein title-Attribut.

alt in figure, picture und srcset

picture und source

Das Element picture zeigt laut HTML-Standard selbst nichts an, und ein source darin repräsentiert für sich genommen nichts. Beide liefern dem enthaltenen img nur alternative Bildquellen. Das alt steht deshalb genau einmal am img und gilt für jede Quelle, die der Browser wählt. Die MDN-Referenz zu picture nennt als erlaubten Inhalt null oder mehr source-Elemente, gefolgt von einem img.

<picture>
  <source srcset="seminarraum.avif" type="image/avif">
  <source srcset="seminarraum.webp" type="image/webp">
  <img src="seminarraum.jpg" alt="Heller Seminarraum mit Stuhlkreis und Blick auf den See" width="1200" height="800">
</picture>

Daraus folgt eine Einschränkung für die Bildauswahl per media: Zeigst du je nach Bildschirmbreite verschiedene Ausschnitte, müssen alle Varianten zum selben Alt-Text passen. Zeigen die Varianten inhaltlich Verschiedenes, ist picture das falsche Werkzeug. Für srcset und sizes direkt am img gilt dasselbe: ein Element, ein alt. Wann sich welches Format lohnt, steht im Beitrag zu AVIF und WebP.

Für die Suche ist das src am img ebenfalls nötig. Google schreibt in der Dokumentation zu Bildern, dass das src-Attribut auch dann ausgewertet wird, wenn das img in einem picture steckt.

figure und figcaption

Eine figcaption ersetzt das alt nicht. Das Bild in einer figure behält sein Attribut, und beide Texte sollen sich unterscheiden: Der Standard verlangt, dass der Alt-Text nichts enthält, was als Bildunterschrift gelten könnte.

<figure>
  <img src="besucher-q1.png" alt="Balkendiagramm: Besucher pro Monat im ersten Quartal, Höchstwert im März">
  <figcaption>Besucherzahlen Januar bis März 2026</figcaption>
</figure>

Enthält ein Link oder Button nichts außer einem Bild, muss das alt laut Standard den Zweck des Links oder Buttons vermitteln. Der Alt-Text ist dann der Linktext. Google nutzt ihn nach eigener Dokumentation als Ankertext, wenn ein Bild als Link dient.

input type=“image”

Ein Bild-Button im Formular ist kein img, hat aber ein eigenes alt. Der HTML-Standard ist hier strenger als beim img: Das Attribut muss vorhanden sein und eine nicht leere Zeichenkette enthalten, die den Button beschriftet. Ein leeres alt ist an dieser Stelle immer ein Fehler. Die WCAG-Technik H36 präzisiert: Der Text nennt die Funktion des Buttons, nicht das Motiv.

<form action="/suche" role="search">
  <label for="q">Suchbegriff</label>
  <input type="search" id="q" name="q">
  <input type="image" src="lupe.png" alt="Suchen" width="24" height="24">
</form>

ARIA in HTML merkt zu diesem Elementtyp an, dass Autoren ein anderes Element erwägen sollten. Ein button mit einem img darin ist in neuen Projekten meist die bessere Wahl.

area in Image Maps

Bei verweissensitiven Grafiken hat jede klickbare Fläche ein eigenes alt. Laut MDN ist es erforderlich, sobald das area ein href hat. Das W3C-Tutorial beschreibt die Aufteilung: Der Alt-Text des Gesamtbildes gibt den Kontext, der Alt-Text jeder Fläche nennt Zweck oder Ziel.

<img src="standorte.png" usemap="#standorte" alt="Karte der Standorte in Bayern">
<map name="standorte">
  <area shape="circle" coords="120,80,20" href="/fuerth" alt="Standort Fürth">
  <area shape="circle" coords="210,190,20" href="/muenchen" alt="Standort München">
</map>

SVG: kein alt am svg-Element

Bei SVG kommt es darauf an, wie die Grafik eingebunden ist.

SVG als Datei im img. Hier gilt alles wie bei jedem anderen Bild. MDN weist auf eine Besonderheit hin: Wegen eines Fehlers sagt VoiceOver SVG-Dateien im img nicht korrekt als Bild an. MDN empfiehlt deshalb zusätzlich role="img".

<img src="logo.svg" alt="Bilder Alt" role="img" width="120" height="32">

Inline-SVG. Das Element svg kennt kein alt. Die MDN-Seite zur Rolle img empfiehlt, dem äußeren svg die Rolle img und einen Namen zu geben. Screenreader behandeln die Grafik dann als eine Einheit und lesen nicht jeden Kindknoten einzeln. Für den Namen gibt es zwei Wege: aria-label, oder ein title-Element im SVG, auf das aria-labelledby verweist. Google nennt für Inline-SVG das title-Element als Entsprechung zum Alt-Text.

<!-- Variante 1: Name per aria-label -->
<svg role="img" aria-label="Umsatz 2025: 40 Prozent Shop, 60 Prozent Handel" viewBox="0 0 100 100">
  <!-- Pfade -->
</svg>

<!-- Variante 2: Name per title-Element -->
<svg role="img" aria-labelledby="umsatz-titel" viewBox="0 0 100 100">
  <title id="umsatz-titel">Umsatz 2025: 40 Prozent Shop, 60 Prozent Handel</title>
  <!-- Pfade -->
</svg>

<!-- Dekoratives Icon neben sichtbarem Text -->
<button type="button">
  <svg aria-hidden="true" viewBox="0 0 24 24"><!-- Pfade --></svg>
  Herunterladen
</button>

Im dritten Beispiel entfernt aria-hidden="true" das Icon aus dem Accessibility Tree, der sichtbare Text beschriftet den Button. Das Muster aus role="img" und aria-label funktioniert laut MDN für jede Gruppe von Elementen, die als ein Bild gelten soll, etwa mehrere Einzelgrafiken in einem div. Die Kindelemente werden dabei als präsentational behandelt. Für ein einzelnes img bleibt alt das Mittel der Wahl.

CSS-Hintergrundbilder haben keinen Alt-Text

Ein Bild, das per background-image eingebunden ist, hat kein alt-Attribut. Das ist für dekorative Bilder gewollt. Die WCAG-Technik C9 beschreibt CSS als Weg, rein dekorative Bilder einzubinden, sodass Hilfsmittel sie ignorieren können. Das W3C-Tutorial empfiehlt das, wo es möglich ist.

Die Kehrseite: Trägt das Hintergrundbild Information, ist das ein dokumentierter Fehler. Die WCAG-Fehlerbeschreibung F3 wertet es als Verstoß gegen Erfolgskriterium 1.1.1, wenn Information ausschließlich über CSS-Hintergrundbilder vermittelt wird. Dazu kommt die Suche: Google indexiert nach eigener Aussage keine CSS-Bilder. Ein Produktfoto oder eine Infografik gehört also in ein img.

<!-- Problematisch: Das Teamfoto trägt Inhalt, hat aber keine Textalternative -->
<div class="hero" style="background-image: url(team.jpg)"></div>

<!-- Besser: echtes Bild, per CSS als Fläche gestaltet -->
<div class="hero">
  <img class="hero__bild" src="team.jpg" alt="Das zwölfköpfige Team vor dem Büroeingang in Fürth">
</div>

Das Inline-CSS im ersten Beispiel dient nur der Kürze. Mit object-fit: cover füllt ein img eine Fläche wie ein Hintergrundbild. Lässt sich ein informatives Hintergrundbild im Bestand nicht umbauen, bleibt als Notlösung role="img" mit aria-label am Container. Für die Bildersuche ändert das nichts.

aria-label statt alt?

Technisch kann ein img seinen Namen auch über aria-label oder aria-labelledby bekommen. Die WCAG-Fehlerbeschreibung F65 prüft bei img, area und input type="image" neben alt auch diese Attribute und title. Sie hält aber fest: Das alt-Attribut bleibt der bevorzugte Weg für Alternativtexte.

Dafür gibt es handfeste Gründe. Der Browser kann den alt-Wert anzeigen, wenn das Bild nicht lädt. Google wertet nach eigener Dokumentation den Alt-Text aus. Und der HTML-Validator verlangt das Attribut unabhängig von ARIA. Setze deshalb am img immer alt und verzichte auf ein zusätzliches aria-label mit anderem Wortlaut. Zwei verschiedene Texte für dasselbe Bild führen zu Ergebnissen, die du nicht mehr überblickst.

Typische Fehler beim Alt-Tag im Code

Die inhaltlichen Fehler, etwa „Bild von“ am Anfang oder Keyword-Listen, behandelt unser Alt-Text-Ratgeber mit Beispielen. Die folgende Tabelle sammelt die Fehler, die im Markup entstehen:

FehlerWarum es ein Fehler istKorrektur
img ganz ohne altValidierungsfehler. Manche Screenreader lesen den Dateinamen vor.alt="…" oder alt="" setzen
alt=" " mit LeerzeichenDer Wert ist nicht die leere Zeichenkette, die der Standard für dekorative Bilder verlangt.alt="" ohne Leerzeichen
alt an picture, source, div oder aDas Attribut ist dort nicht definiert und wird nicht ausgewertet.An das img setzen
title statt altLaut MDN ist title kein akzeptabler Ersatz für alt.alt setzen, title weglassen
Platzhalter oder Dateiname als Wert, etwa alt="IMG_4711.jpg" oder alt="spacer"WCAG-Fehler F30 und F39: Der Text ist keine echte Alternative, oder ein Bild, das ignoriert werden soll, hat einen nicht leeren Alt-Text.Beschreiben oder leeren
Nicht leeres alt mit role="presentation"Widerspruch. ARIA in HTML erlaubt die Rolle an diesem Bild nicht.Eines von beiden entfernen
Leeres alt an einem Bild, das als einziges in einem Link stehtDer Link hat keinen Namen. Laut W3C lesen Screenreader dann oft Dateinamen oder URL vor.Linkziel ins alt schreiben
Leeres oder fehlendes alt an input type="image"Der Standard verlangt hier einen nicht leeren Wert.Funktion benennen, zum Beispiel alt="Suchen"
Template gibt alt="undefined", alt="null" oder den Seitentitel für jedes Bild ausPlatzhaltertext im Sinne von F30. Entsteht durch ungeprüfte Variablen.Im Template auf leeren Wert prüfen und dann alt="" ausgeben
Information nur im CSS-HintergrundbildWCAG-Fehler F3. Google indexiert das Bild nicht.Als img mit alt einbinden

Die Nummern F30 und F39 stammen aus der Liste der Fehler zum Erfolgskriterium 1.1.1 „Nicht-Text-Inhalt“ (Stufe A). Dort findest du auch F38: dekorative Bilder, die nicht so ausgezeichnet sind, dass Hilfsmittel sie ignorieren können.

Alt-Attribute im Code prüfen

1. Selektoren in der Browser-Konsole

Der Attributselektor unterscheidet sauber zwischen fehlendem und leerem Attribut. Damit findest du auf der geladenen Seite jede Fehlerklasse einzeln:

// Bilder ganz ohne alt-Attribut
document.querySelectorAll('img:not([alt])');

// Bilder mit leerem alt: Ist jedes davon wirklich dekorativ?
document.querySelectorAll('img[alt=""]');

// alt, das nur aus Leerraum besteht
[...document.querySelectorAll('img[alt]')]
  .filter(img => img.alt !== '' && img.alt.trim() === '');

// Verlinkte Bilder ohne Alt-Text
document.querySelectorAll('a img:not([alt]), a img[alt=""]');

// Bild-Buttons und Image-Map-Flächen ohne Beschriftung
document.querySelectorAll('input[type="image"]:not([alt]), input[type="image"][alt=""], area[href]:not([alt])');

// Inline-SVG ohne Namen und ohne aria-hidden
document.querySelectorAll('svg:not([aria-hidden="true"]):not([aria-label]):not([aria-labelledby])');

// Übersicht aller Bilder als Tabelle
console.table([...document.images].map(img => ({
  src: img.currentSrc || img.src,
  alt: img.getAttribute('alt')
})));

Zwei Hinweise zur Auswertung. Der vierte Selektor liefert auch Icons neben Linktext, bei denen das leere alt richtig ist. Du musst die Treffer ansehen. In der Tabelle zeigt getAttribute('alt') für fehlende Attribute null und für leere eine leere Zeichenkette. Die Eigenschaft img.alt würde in beiden Fällen eine leere Zeichenkette liefern.

2. HTML-Validator

Der Nu Html Checker des W3C prüft Dokumente gegen den HTML-Standard und meldet damit auch fehlende alt-Attribute nach den oben genannten Regeln. Er lässt sich im Browser und für Stapelprüfungen auf der Kommandozeile nutzen. Das W3C beschreibt ihn als laufendes Experiment und ausdrücklich als Prüfwerkzeug, nicht als Zertifizierung. Ein Validator erkennt, ob das Attribut da ist. Ob der Text zum Bild passt, erkennt er nicht.

3. Accessibility Tree in den DevTools

Was ein Screenreader tatsächlich bekommt, zeigt der Accessibility Tree. In Chrome wählst du laut DevTools-Dokumentation im Panel „Elements“ das Element aus und öffnest den Tab „Accessibility“. Unter „Computed Properties“ stehen die berechneten Eigenschaften des Knotens. Das ist der schnellste Weg, um Sonderfälle zu klären: ein SVG mit title, ein Bild mit alt und aria-label, ein Container mit role="img".

4. Lint-Regel im Build

Fehler, die gar nicht erst ins Repository kommen, musst du später nicht suchen. Für React-Projekte prüft die Regel alt-text aus eslint-plugin-jsx-a11y standardmäßig img, area, input type="image" und object. Sie akzeptiert am img einen Text oder einen leeren String für dekorative Bilder. Ein img ohne alt lässt sie auch dann nicht durch, wenn role="presentation" gesetzt ist. Eigene Bildkomponenten kannst du über die Option elements einbeziehen.

Alle vier Wege prüfen das Vorhandensein, nicht die Qualität. Wie du Bilder im Rahmen einer Gesamtprüfung testest, auch mit Scannern wie WAVE und Lighthouse, beschreibt der Beitrag Barrierefreiheit der Website testen.

Woher der Alt-Text im CMS kommt

In WordPress und Contao schreibt niemand das Attribut von Hand. Das Template liest ein Feld aus der Mediathek oder den Datei-Metadaten und gibt es als alt aus. Für Entwickler heißt das zweierlei. Das Template muss das Attribut immer ausgeben, auch wenn das Feld leer ist, damit aus einem fehlenden Text kein fehlendes Attribut wird. Und die Redaktion braucht einen Weg, die Felder zu füllen.

Für den zweiten Teil gibt es Werkzeuge. Bilder Alt ist unser eigenes: Es erzeugt Alt-Texte per KI in der Web-App, über das WordPress-Plugin beim Upload und gesammelt für die bestehende Mediathek, und über die Contao-Erweiterung, die auch Bilder ohne Alt-Text auflistet. Die Bilderkennung läuft über die API von OpenAI. Details stehen in der Datenschutzerklärung. Die Vorschläge musst du prüfen. Ob ein Bild dekorativ ist, ob es in einem Link steht und was dieser Link tut, weiß nur, wer die Seite kennt. Dekorative Bilder bekommen weiterhin ein leeres alt.

Häufige Fragen

Heißt es Alt-Tag oder Alt-Attribut?

Korrekt ist Alt-Attribut. alt steht als Attribut im Start-Tag des img-Elements, ein eigenes Tag gibt es nicht. „Alt-Tag“ hat sich im Sprachgebrauch trotzdem gehalten und meint dasselbe.

Ist alt=”” ein Fehler?

Nein. Das leere Attribut ist die im HTML-Standard vorgesehene Auszeichnung für dekorative Bilder und für Icons neben gleichlautendem Text. Ein Fehler ist es nur dort, wo das Bild Inhalt oder eine Funktion trägt, zum Beispiel als einziger Inhalt eines Links, und immer bei input type="image".

Was ist der Unterschied zwischen leerem und fehlendem alt?

Ein leeres alt sagt: Dieses Bild ist dekorativ, Hilfsmittel können es übergehen. Ein fehlendes alt sagt laut Standard: Das Bild ist möglicherweise wichtig, aber es gibt keinen Ersatztext. Manche Screenreader lesen dann den Dateinamen vor.

Wohin gehört das alt bei picture?

An das img innerhalb des picture. Die source-Elemente liefern nur alternative Dateien für dieses eine Bild. Ein alt an picture oder source hat keine Wirkung.

Wie gebe ich einem Inline-SVG einen Alternativtext?

Mit role="img" am svg-Element und einem Namen, entweder über aria-label oder über ein title-Element, auf das aria-labelledby zeigt. Dekorative Inline-SVGs blendest du mit aria-hidden="true" für Hilfsmittel aus.

Reicht role=“presentation” statt alt?

Nein. Der HTML-Standard verlangt das alt-Attribut unabhängig von ARIA, und das W3C weist darauf hin, dass role="presentation" weniger breit unterstützt wird als ein leeres alt. Für dekorative Bilder ist alt="" die einfachere und robustere Lösung.

Nächster Schritt

Öffne eine wichtige Seite deines Projekts, führe den ersten Selektor aus der Liste oben aus und sieh dir die Treffer an. Sind es wenige, korrigiere sie von Hand. Fehlen Alt-Texte in der Breite, kannst du dir im kostenlosen Alt-Text-Generator ohne Konto einen Vorschlag ansehen oder dich in der Web-App von Bilder Alt anmelden. Mit Konto sind 25 Credits gratis, danach kostet ein Bild 0,01 €.

Quellen

  • Kontakt

  • BlueBranch GmbH
    Hans-Vogel-Straße 59
    90765 Fürth

  • Telefon: +49 9131 9430090
    E-Mail: hello@bluebranch.de

  • Web: https://www.bluebranch.de