Ein Menü, das sich nicht per Tastatur öffnen lässt, ein Formularfeld ohne Beschriftung, ein mit div gebauter „Button“: für sich kleine Fehler. Das Problem ist, dass sie, aus der Komponentenbibliothek in Dutzende Bildschirme kopiert, erst im Prüfbericht vor der Veröffentlichung auftauchen. Dann ist die Korrektur teuer. Dieser Leitfaden übersetzt die Erfolgskriterien von WCAG 2.2 in die täglichen Entscheidungen von Frontend-Entwicklern: semantisches HTML, ARIA, Tastatur und Fokus, Formulare, Kontrast und Testablauf, auf Komponentenebene.
WCAG-Struktur und Konformitätsstufen
Die WCAG (Web Content Accessibility Guidelines) werden vom W3C veröffentlicht und beruhen auf vier Prinzipien: wahrnehmbar, bedienbar, verständlich und robust (POUR). Unter jedem Prinzip stehen Richtlinien, unter den Richtlinien testbare Erfolgskriterien. Jedes Kriterium hat die Stufe A, AA oder AAA; in Unternehmens-Webprojekten und in gesetzlichen Verweisen ist das Ziel meist AA, also alle A- und AA-Kriterien.
WCAG 2.2 hat gegenüber 2.1 neue Kriterien hinzugefügt und das Kriterium 4.1.1 Parsing entfernt. Die neuen Kriterien, die Entwickler direkt betreffen:
| Kriterium | Stufe | Entsprechung im Code |
|---|---|---|
| 2.4.11 Focus Not Obscured (Minimum) | AA | Sticky Header/Cookie-Banner darf das fokussierte Element nicht vollständig verdecken |
| 2.5.7 Dragging Movements | AA | Drag-and-Drop-Vorgänge brauchen eine Alternative mit einfachem Zeiger |
| 2.5.8 Target Size (Minimum) | AA | Klickziele mindestens 24×24 CSS-Pixel oder mit ausreichendem Abstand |
| 3.2.6 Consistent Help | A | Hilfe-Link auf den Seiten an derselben relativen Position |
| 3.3.7 Redundant Entry | A | Im selben Prozess eingegebene Informationen nicht erneut verlangen oder automatisch ausfüllen |
| 3.3.8 Accessible Authentication (Minimum) | AA | Bei der Anmeldung kein verpflichtender kognitiver Test; Passwortmanager und Einfügen nicht blockieren |
Primärquelle für den vollständigen Text der Kriterien und die „Understanding“-Dokumente ist die Seite W3C WCAG 2.2 Recommendation. Orientieren Sie sich bei der Auslegung eines Kriteriums nicht an Blogbeiträgen, sondern an den Beispielen und Ausnahmen in diesen Dokumenten. Dort endet die Diskussion.
Semantisches HTML und Einsatz von ARIA
Ein Großteil der Barrierefreiheitsfehler wird mit dem richtigen HTML-Element gelöst. Ein <button> ist per Tastatur fokussierbar, wird mit Enter und Leertaste ausgelöst und dem Screenreader als „Schaltfläche“ gemeldet. Um dasselbe Verhalten mit <div onclick> zu erreichen, müssen tabindex, role und Tastatur-Event-Handler ergänzt werden; im Code-Review sehen wir oft, dass mindestens eines davon fehlt. Die Kriterien 1.3.1 Info and Relationships und 4.1.2 Name, Role, Value sind die direkte Entsprechung dieser Fehler.
- Verwenden Sie für Seitenbereiche
header,nav,main,footer; Screenreader-Nutzer springen zwischen diesen Bereichen. - Wählen Sie die Überschriftenebene nicht nach visueller Größe, sondern nach Inhaltshierarchie; das Aussehen regelt CSS.
<a href>für Navigation,<button>für Aktionen. Ein „Button“, der die Seite wechselt, oder ein „Link“, der eine Aktion ausführt, bricht die Erwartung des Benutzers.- Markieren Sie Tabellendaten mit
<table>, Kopfzellen mit<th scope>.
Die erste Regel von ARIA: Gibt es ein gleichwertiges natives HTML-Element, verwenden Sie kein ARIA. ARIA ändert nur die Informationen im Barrierefreiheitsbaum und fügt kein Verhalten hinzu. Ein Element mit role="button" lässt sich weiterhin nicht per Tastatur auslösen. Die Rolle ist ein Etikett, kein Motor. Wirklich nötig ist ARIA bei Komponenten ohne HTML-Entsprechung: Registerkarten, Kombinationsfeld (Combobox), Baumansicht, Menü-Button. Die erwarteten Rollen, Zustände und Tastaturverhalten dieser Muster sind im W3C ARIA Authoring Practices Guide definiert; weichen Sie beim Schreiben eigener Komponenten nicht von diesen Mustern ab.
<!-- Falsch: Icon-Button hat keinen zugaenglichen Namen -->
<button><svg>…</svg></button>
<!-- Richtig: unsichtbarer Name + dekoratives Icon -->
<button aria-label="Filter zuruecksetzen">
<svg aria-hidden="true" focusable="false">…</svg>
</button>
<!-- Ausklappbereich: Zustand wird per ARIA gemeldet -->
<button aria-expanded="false" aria-controls="filter-bereich">Filter</button>
<div id="filter-bereich" hidden>…</div>
Tastaturzugang und Fokusverwaltung
2.1.1 Keyboard verlangt, dass alle Funktionen per Tastatur nutzbar sind, 2.1.2 No Keyboard Trap, dass der Fokus nach dem Betreten einer Komponente dort nicht gefangen bleibt. 2.4.3 Focus Order fordert eine sinnvolle Reihenfolge, 2.4.7 Focus Visible einen sichtbaren Fokus. Im Code bedeutet das:
- Verwenden Sie keine positiven
tabindex-Werte (1, 2, 3…); die Fokusreihenfolge bestimmt die DOM-Reihenfolge. Weicht die visuelle Reihenfolge per CSS von der DOM-Reihenfolge ab (z. B.order,flex-direction: row-reverse), scheint der Fokus für den Benutzer zufällig zu springen. - Haben Sie den Fokusring mit
outline: noneentfernt, definieren Sie mit:focus-visibleeine deutliche Alternative. Der Fehler, den wir in der Praxis am häufigsten finden, ist eine CSS-Reset-Datei, die den Fokusring stillschweigend löscht. - Verschieben Sie beim Öffnen eines Modals den Fokus hinein, verhindern Sie, dass er bei geöffnetem Modal in den Hintergrund entweicht, schließen Sie es mit Escape und geben Sie den Fokus nach dem Schließen an den auslösenden Button zurück. Die Methode
showModal()des nativen Elements<dialog>macht den Hintergrund inaktiv (inert) und liefert das Escape-Verhalten. - In Single-Page-Anwendungen bleibt der Fokus nach einem Routenwechsel auf dem angeklickten Link der alten Seite. Verschieben Sie den Fokus auf die Hauptüberschrift der neuen Seite (mit
tabindex="-1") und aktualisieren Siedocument.title. - Setzen Sie vor lange Navigationsmenüs einen Link „Zum Inhalt springen“ (2.4.1 Bypass Blocks).
/* Fokussichtbarkeit: deutlicher Ring nur beim Tastaturfokus */
:focus-visible {
outline: 3px solid var(--color-focus);
outline-offset: 2px;
}
/* Sticky Header soll das fokussierte Element nicht verdecken (2.4.11) */
html { scroll-padding-top: 5rem; }
Formulare, Fehlermeldungen und dynamische Inhalte
In individuellen Webanwendungen sind Formulare der Ort mit den meisten Barrierefreiheitsfehlern. Jedes Feld braucht eine programmatisch verknüpfte Beschriftung (<label for>). placeholder ersetzt keine Beschriftung: Er verschwindet beim Tippen, und sein Kontrast ist meist gering. Zusammengehörige Felder (Adressblock, Optionsgruppe) werden mit <fieldset> und <legend> gruppiert.
Auf Fehlerseite verlangt 3.3.1 Error Identification, dass der Fehler in Textform angegeben wird, 3.3.3 Error Suggestion, dass möglichst ein Korrekturvorschlag gemacht wird. Ein roter Rahmen allein genügt nicht (1.4.1 Use of Color). Ein farbenblinder Benutzer sieht nicht, welches Feld fehlerhaft ist.
<label for="steuer-nr">Steuernummer</label>
<input id="steuer-nr" name="steuerNr" inputmode="numeric"
autocomplete="off"
aria-invalid="true"
aria-describedby="steuer-nr-hinweis steuer-nr-fehler">
<p id="steuer-nr-hinweis">Geben Sie Ihre 10-stellige Steuernummer ein.</p>
<p id="steuer-nr-fehler">Die Steuernummer muss aus 10 Ziffern bestehen.</p>
Gibt es beim Absenden mehrere Fehler, setzen Sie eine Fehlerübersicht an den Formularanfang, verschieben den Fokus dorthin und verknüpfen jeden Eintrag der Übersicht mit dem betreffenden Feld. Validierungsregeln konsistent auf Client und Server aufzubauen und Serverfehler Feldern zuzuordnen, behandelt der Leitfaden Formularvalidierung mit einem einzigen Schema verwalten.
Inhalte, die sich ohne Neuladen der Seite ändern („Gespeichert“, „3 Ergebnisse gefunden“, Abschluss eines Hintergrundvorgangs), fallen unter 4.1.3 Status Messages. Diese Meldungen werden ohne Fokusverschiebung angekündigt: role="status" (höflich, bei nächster Gelegenheit vorgelesen) oder role="alert" für dringende Fehler. Das Live-Region-Element muss im DOM vorhanden sein, bevor sich der Inhalt ändert. Eine gleichzeitig mit der Meldung ins DOM eingefügte Live Region wird in vielen Kombinationen aus Screenreader und Browser nicht zuverlässig angekündigt; Benachrichtigungen, die „bei uns funktionieren“, in NVDA aber stumm bleiben, haben meist diese Ursache.
Kontrast, Bewegung und visuelles Layout
| Thema | Kriterium | Schwellenwert |
|---|---|---|
| Kontrast normaler Text | 1.4.3 (AA) | Mindestens 4,5:1 |
| Kontrast großer Text | 1.4.3 (AA) | Mindestens 3:1 (18 pt oder 14 pt fett) |
| Kontrast von UI-Komponenten und Grafiken | 1.4.11 (AA) | Mindestens 3:1 |
| Umbruch (Reflow) | 1.4.10 (AA) | Bei 320 CSS-Pixel Breite ohne horizontales Scrollen |
| Textgröße ändern | 1.4.4 (AA) | Kein Funktionsverlust bei 200 % Vergrößerung |
Messen Sie Kontrast nicht auf jedem Bildschirm einzeln; prüfen Sie ihn auf Ebene der Design Tokens und führen Sie eine Liste freigegebener Farbpaare. Dieser Ansatz wird im Leitfaden Unternehmens-Designsystem zusammen mit der Token-Verwaltung beschrieben. Deaktivierte (disabled) Komponenten sind vom Kontrastkriterium ausgenommen; versteht der Benutzer aber nicht, warum sie deaktiviert sind, ist das dennoch ein Usability-Problem.
Parallax, automatisch drehende Karussells und große Übergangsanimationen betreffen Benutzer mit vestibulären Beschwerden. 2.2.2 Pause, Stop, Hide (A) verlangt, dass selbst startende Bewegung, die länger als fünf Sekunden dauert und zusammen mit anderen Inhalten präsentiert wird, pausiert, gestoppt oder ausgeblendet werden kann. Die Einstellung „Bewegung reduzieren“ des Betriebssystems zu respektieren, ist eine Sache weniger Zeilen; das folgende Beispiel tut das mit einer allgemeinen Regel:
@media (prefers-reduced-motion: reduce) {
*, *::before, *::after {
animation-duration: 0.01ms !important;
animation-iteration-count: 1 !important;
transition-duration: 0.01ms !important;
scroll-behavior: auto !important;
}
}
Testmethode und Komponenten-Checkliste
Automatische Werkzeuge (axe-core, Lighthouse-Barrierefreiheitsprüfung, WAVE) finden fehlenden Alternativtext, geringen Kontrast, unbeschriftete Felder und ungültige ARIA-Attribute schnell. Ob die Fokusreihenfolge logisch ist, ob ein Alternativtext etwas aussagt und ob ein Modal per Tastatur bedienbar ist, können sie dagegen nicht bewerten. Ein grüner Bericht bedeutet keine barrierefreie Anwendung. Bauen Sie den Testablauf daher in drei Ebenen auf:
- Entwicklung und CI: Führen Sie in Komponententests mit
jest-axeoder Playwright mit@axe-core/playwrightfür jede Komponente und kritische Seite einen automatischen Scan durch; tritt ein neuer Verstoß auf, soll der Build brechen. - Tastaturtest: Legen Sie die Maus beiseite. Durchlaufen Sie jeden Arbeitsablauf von Anfang bis Ende mit Tab, Umschalt+Tab, Enter, Leertaste, Escape und Pfeiltasten. Der Fokus muss jederzeit sichtbar und die Reihenfolge logisch sein.
- Screenreader-Test: Hören Sie kritische Abläufe unter Windows mit NVDA, unter macOS und iOS mit VoiceOver und unter Android mit TalkBack ab. Name, Rolle und Zustand jeder Komponente müssen korrekt vorgelesen und Statusmeldungen angekündigt werden.
// Seitenscan mit Playwright + axe
import { test, expect } from '@playwright/test';
import AxeBuilder from '@axe-core/playwright';
test('Bestellliste enthaelt keine WCAG-AA-Verstoesse', async ({ page }) => {
await page.goto('/bestellungen');
const results = await new AxeBuilder({ page })
.withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa', 'wcag22aa'])
.analyze();
expect(results.violations).toEqual([]);
});
Komponenten-Checkliste
- Button: Natives
<button>; zugänglicher Name bei Icon-Buttons; Zielgröße mindestens 24×24 CSS-Pixel. - Modal: Beim Öffnen liegt der Fokus innen, schließt mit Escape, nach dem Schließen kehrt der Fokus zurück, Titel per
aria-labelledbyverknüpft. - Ausklappmenü / Combobox: Pfeiltastenverhalten gemäß APG-Muster,
aria-expandedaktuell, ausgewählte Option wird gemeldet. - Formularfeld: Sichtbare Beschriftung, Hinweis und Fehler per
aria-describedbyverknüpft, Fehler in Textform,autocompletemit korrektem Wert. - Tabelle: Kopfzellen mit
thundscope; bei sortierbaren Spaltenaria-sort. - Benachrichtigung: Bereits im DOM vorhandener Bereich mit
role="status"; bei selbst verschwindenden Benachrichtigungen ausreichende Dauer oder dauerhafte Alternative. - Bild: Bei bedeutungstragenden Bildern beschreibendes
alt, bei dekorativen Bildern leeresalt="".
Lösen Sie Barrierefreiheit auf Ebene der Komponentenbibliothek, wird derselbe Fehler nicht auf jedem Bildschirm neu gemacht; die Korrektur erfolgt einmal und verbreitet sich überall. Für den Aufbau eines barrierefreien Komponentensets zusammen mit dem Designsystem sehen Sie sich die Leistungsseite UI/UX und Unternehmens-Designsystem an.
Häufig gestellte Fragen
Welche WCAG-Stufe sollte für eine Unternehmens-Webanwendung angestrebt werden?
Das übliche Ziel ist WCAG 2.2 Stufe AA; das bedeutet, alle Erfolgskriterien der Stufen A und AA zu erfüllen. Da nicht alle AAA-Kriterien auf jeden Inhalt anwendbar sind, werden meist nur ausgewählte Kriterien angestrebt.
Reichen automatische Barrierefreiheitswerkzeuge aus?
Nein. axe-core oder Lighthouse finden maschinell messbare Fehler wie Kontrast, fehlende Beschriftungen und ungültiges ARIA. Die Logik der Fokusreihenfolge, die Aussagekraft von Alternativtexten und die Bedienbarkeit komplexer Komponenten erfordern manuelle Tests mit Tastatur und Screenreader.
Verbessert das Hinzufügen von ARIA immer die Barrierefreiheit?
Nein. ARIA ändert nur die an Hilfstechnologien übermittelte Information und fügt kein Verhalten hinzu. Mit falscher Rolle oder fehlender Tastaturunterstützung hinzugefügtes ARIA kann schlechtere Ergebnisse liefern als gar kein ARIA. Verwenden Sie zuerst das native HTML-Element.
Welche Bereiche sind beim Umstieg auf WCAG 2.2 am stärksten betroffen?
Am häufigsten betroffen sind kleine Klickziele, Sticky Header, die das fokussierte Element verdecken, Drag-and-Drop-Oberflächen und Anmeldebildschirme, die das Einfügen von Passwörtern blockieren oder einen kognitiven Test verlangen.