Barrierefreiheit in Webanwendungen mit WCAG 2.2: Leitfaden für Entwickler

Setzen Sie WCAG-2.2-Kriterien in Code um: semantisches HTML, ARIA, Tastatur- und Fokusverwaltung, Formularfehler, Kontrast, CI-Test mit axe und komponentenbasierte Checkliste.
Technische Zusammenfassung
Technologie
WCAG 2.2, WAI-ARIA, HTML, CSS, axe-core, Playwright, NVDA, VoiceOver
Thema
WCAG-2.2-AA-Kriterien in Webanwendungen im Code umsetzen
Niveau
Mittel
Voraussetzungen
  • Grundkenntnisse in HTML und CSS
  • Erfahrung mit einem komponentenbasierten Frontend-Framework
In diesem Beitrag7 Abschnitte

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: none entfernt, definieren Sie mit :focus-visible eine 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 Sie document.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:

  1. Entwicklung und CI: Führen Sie in Komponententests mit jest-axe oder Playwright mit @axe-core/playwright für jede Komponente und kritische Seite einen automatischen Scan durch; tritt ein neuer Verstoß auf, soll der Build brechen.
  2. 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.
  3. 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-labelledby verknüpft.
  • Ausklappmenü / Combobox: Pfeiltastenverhalten gemäß APG-Muster, aria-expanded aktuell, ausgewählte Option wird gemeldet.
  • Formularfeld: Sichtbare Beschriftung, Hinweis und Fehler per aria-describedby verknüpft, Fehler in Textform, autocomplete mit korrektem Wert.
  • Tabelle: Kopfzellen mit th und scope; bei sortierbaren Spalten aria-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 leeres alt="".

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.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge