Accessibility Auditor (Barrierefreiheitsprüfer)
Prüft Webanwendungen auf Einhaltung der Barrierefreiheitsstandards (WCAG 2.1 Level AA) und schlägt Verbesserungen vor.
Wann verwenden
- Beim Entwickeln oder Überprüfen von UI-Komponenten
- Wenn Benutzer Verbesserungen der Barrierefreiheit anfordern
- Bei der Vorbereitung eines Barrierefreiheits-Audits
- Wenn der Benutzer "Barrierefreiheit", "a11y", "WCAG", "Screenreader" oder "Tastaturnavigation" erwähnt
Anleitung
1. Prüfung auf semantisches HTML
Verwenden Sie die richtigen HTML-Elemente:
<!-- Schlecht -->
<div onclick="submit()">Absenden</div>
<!-- Gut -->
<button onclick="submit()">Absenden</button>
Semantische Struktur:
<header>,<nav>,<main>,<footer><article>,<section>,<aside><h1>bis<h6>in korrekter Hierarchie<button>für Aktionen,<a>für Navigation
2. ARIA-Attribute
Wann ARIA verwendet werden sollte:
- Benutzerdefinierte Widgets (Tabs, Akkordeons, Modalfenster)
- Dynamische Inhaltsaktualisierungen
- Komplexe Interaktionen
- Wenn semantisches HTML nicht ausreicht
Häufige ARIA-Attribute:
<!-- Landmark-Rollen -->
<nav role="navigation" aria-label="Hauptnavigation">
<!-- Widget-Rollen -->
<div role="button" tabindex="0" aria-pressed="false">
<!-- Live-Regionen -->
<div role="alert" aria-live="assertive">Ein Fehler ist aufgetreten</div>
<!-- Bezeichnungen und Beschreibungen -->
<button aria-label="Dialog schließen">×</button>
<input aria-describedby="passwort-hilfe" />
Erste ARIA-Regel: Verwenden Sie ARIA nicht, wenn semantisches HTML funktioniert.
3. Tastaturnavigation
Alle interaktiven Elemente müssen per Tastatur erreichbar sein:
// Tastaturunterstützung für benutzerdefinierte Elemente hinzufügen
<div
role="button"
tabindex="0"
onClick={handleClick}
onKeyDown={(e) => {
if (e.key === 'Enter' || e.key === ' ') {
handleClick();
}
}}
>
Klick mich
</div>
Tab-Reihenfolge:
- Verwenden Sie
tabindex="0"für benutzerdefinierte interaktive Elemente - Vermeiden Sie
tabindex > 0(erzeugt verwirrende Tab-Reihenfolge) - Verwenden Sie
tabindex="-1"nur für programmatischen Fokus
Fokusmanagement:
- Sichtbare Fokusindikatoren
- Fokus in Modalfenstern einfangen
- Fokus zurückgeben, wenn Dialoge geschlossen werden
- Sprunglinks zum Hauptinhalt
4. Alternativtexte und Bilder
Informative Bilder:
<img src="diagramm.png" alt="Umsatz im 3. Quartal um 25% gestiegen" />
Dekorative Bilder:
<img src="dekoration.png" alt="" />
<!-- oder -->
<img src="dekoration.png" role="presentation" />
Komplexe Bilder:
<figure>
<img src="komplexes-diagramm.png" alt="Quartalsdiagramm Umsatz" />
<figcaption>
Detaillierte Beschreibung der Diagrammdaten...
</figcaption>
</figure>
5. Farbe und Kontrast
Kontrastverhältnisse (WCAG AA):
- Normaler Text: mindestens 4,5:1
- Großer Text (18pt+): mindestens 3:1
- UI-Komponenten: mindestens 3:1
Nicht nur auf Farbe verlassen:
<!-- Schlecht: Nur Farbe -->
<span style="color: red;">Fehler</span>
<!-- Gut: Symbol + Farbe -->
<span style="color: red;">
<svg aria-hidden="true"><!-- Fehlersymbol --></svg>
<span class="sr-only">Fehler: </span>
Ungültige Eingabe
</span>
6. Formulare und Bezeichnungen
Jede Eingabe benötigt eine Bezeichnung:
<!-- Explizite Bezeichnung -->
<label for="email">E-Mail</label>
<input id="email" type="email" />
<!-- Implizite Bezeichnung -->
<label>
E-Mail
<input type="email" />
</label>
<!-- aria-label für Symbolschaltflächen -->
<button aria-label="Suchen">
<svg><!-- Suchsymbol --></svg>
</button>
Fehlermeldungen:
<input
id="passwort"
aria-invalid="true"
aria-describedby="passwort-fehler"
/>
<div id="passwort-fehler" role="alert">
Das Passwort muss mindestens 8 Zeichen lang sein
</div>
7. Überschriften und Dokumentenstruktur
Korrekte Überschriftenhierarchie:
<h1>Seitentitel</h1>
<h2>Abschnitt 1</h2>
<h3>Unterabschnitt 1.1</h3>
<h3>Unterabschnitt 1.2</h3>
<h2>Abschnitt 2</h2>
Keine Ebenen überspringen: h1 → h2 → h3 (nicht h1 → h3)
8. Dynamische Inhalte
Aktualisierungen an Screenreader ankündigen:
<!-- Höflich: Auf Pause des Benutzers warten -->
<div role="status" aria-live="polite">
5 neue Nachrichten
</div>
<!-- Bestimmt: Sofort unterbrechen -->
<div role="alert" aria-live="assertive">
Ihre Sitzung läuft in 1 Minute ab
</div>
Ladezustände:
<button aria-busy="true" aria-label="Ladevorgang...">
<span aria-hidden="true">Laden</span>
</button>
9. Screenreader-Tests
Nur-für-Screenreader-Text:
.sr-only {
position: absolute;
width: 1px;
height: 1px;
padding: 0;
margin: -1px;
overflow: hidden;
clip: rect(0, 0, 0, 0);
white-space: nowrap;
border-width: 0;
}
Dekorative Elemente ausblenden:
<svg aria-hidden="true"><!-- Symbol --></svg>
10. Häufige Probleme, die zu prüfen sind
Fehlend:
- Alternativtexte auf Bildern
- Bezeichnungen für Formulareingaben
- Korrekte Überschriftenhierarchie
- Tastatur-Fokusindikatoren
- ARIA-Bezeichnungen auf Symbolschaltflächen
Unzureichend:
- Text mit geringem Kontrast
- Nicht-semantisches Markup (divs als Schaltflächen)
- Fehlendes Fokusmanagement in Modalfenstern
- Tastaturfallen
- Automatisch abspielende Medien
Tests:
- Nur Tastaturnavigation
- Screenreader (NVDA, JAWS, VoiceOver)
- Simulation von Farbenblindheit
- Zoom auf 200%
- Automatisierte Tools (axe, Lighthouse)
11. Automatisierte Tests
Werkzeuge:
# Lighthouse
npx lighthouse https://example.com --only-categories=accessibility
# axe-core
npm install --save-dev @axe-core/cli
npx axe https://example.com
# pa11y
npm install --save-dev pa11y
npx pa11y https://example.com
In Tests:
import { axe } from 'jest-axe';
test('sollte keine Barrierefreiheitsverstöße aufweisen', async () => {
const { container } = render(<MyComponent />);
const results = await axe(container);
expect(results).toHaveNoViolations();
});
12. WCAG 2.1 Level AA Checkliste
Wahrnehmbar:
- Textalternativen für nicht-textliche Inhalte
- Untertitel für Audio/Video
- Inhalte anpassbar (semantisches Markup)
- Ausreichender Farbkontrast
Bedienbar:
- Tastaturzugänglich
- Keine Tastaturfallen
- Angemessene Zeitlimits (anpassbar)
- Kein anfallsauslösendes Flackern
- Sprunglinks zur Navigation
- Aussagekräftige Seitentitel
- Fokusreihenfolge ergibt Sinn
- Linkzweck aus dem Kontext klar
Verständlich:
- Sprache der Seite angegeben (
<html lang="de">) - Vorhersehbare Navigation
- Eingabehilfe (Bezeichnungen, Anleitungen, Fehlermeldungen)
Robust:
- Gültiges HTML
- Name, Rolle, Wert für benutzerdefinierte Widgets
- Kompatibel mit unterstützenden Technologien
Best Practices
- Barrierefreiheit von Anfang an integrieren
- Mit echten unterstützenden Technologien testen
- Zuerst semantisches HTML, dann ARIA
- Logische Dokumentenstruktur beibehalten
- Mehrere Möglichkeiten zum Zugriff auf Inhalte bieten
- Tastaturnavigation gründlich testen
- Zoom nicht deaktivieren
- Landmarken und Überschriften verwenden
Unterstützende Dateien
reference/wcag-checklist.md: Vollständige WCAG 2.1 AA-Checklistereference/aria-patterns.md: Häufige ARIA-Widget-Muster


