Was macht WCAG-Audit-Muster?
Umfassender Leitfaden zur Überprüfung von Webinhalten gemäß WCAG 2.2 mit umsetzbaren Sanierungsstrategien.
Wann dieses Skill verwenden
- Durchführung von Barrierefreiheitsaudits
- Behebung von WCAG-Verstößen
- Implementierung barrierefreier Komponenten
- Vorbereitung auf Klagen wegen fehlender Barrierefreiheit
- Erfüllung von ADA/Section 508-Anforderungen
- Erreichung der VPAT-Konformität
Kernkonzepte
1. WCAG-Konformitätsstufen
| Stufe | Beschreibung | Erforderlich für |
|---|---|---|
| A | Minimale Barrierefreiheit | Rechtliche Basis |
| AA | Standardkonformität | Die meisten Vorschriften |
| AAA | Erweiterte Barrierefreiheit | Spezielle Anforderungen |
2. POUR-Prinzipien
Wahrnehmbar: Können Nutzer die Inhalte wahrnehmen?
Bedienbar: Können Nutzer die Oberfläche bedienen?
Verständlich: Können Nutzer die Inhalte verstehen?
Robust: Funktioniert es mit assistiven Technologien?
3. Häufige Verstöße nach Auswirkung
Kritisch (Blocker):
├── Fehlender Alternativtext für funktionale Bilder
├── Kein Tastaturzugriff auf interaktive Elemente
├── Fehlende Formularbeschriftungen
└── Automatisch abgespielte Medien ohne Steuerelemente
Schwerwiegend:
├── Unzureichender Farbkontrast
├── Fehlende Skip-Links
├── Nicht zugängliche benutzerdefinierte Widgets
└── Fehlende Seitentitel
Mäßig:
├── Fehlendes Sprachattribut
├── Unklarer Linktext
├── Fehlende landmarks
└── Fehlerhafte Überschriftenhierarchie
Audit-Checkliste
Wahrnehmbar (Prinzip 1)
## 1.1 Textalternativen
### 1.1.1 Nicht-Text-Inhalt (Niveau A)
- [ ] Alle Bilder haben Alternativtext
- [ ] Dekorative Bilder haben alt=""
- [ ] Komplexe Bilder haben lange Beschreibungen
- [ ] Symbole mit Bedeutung haben zugängliche Namen
- [ ] CAPTCHAs haben Alternativen
Prüfung:
```html
<!-- Gut -->
<img src="chart.png" alt="Umsatz stieg um 25% von Q1 auf Q2" />
<img src="decorative-line.png" alt="" />
<!-- Schlecht -->
<img src="chart.png" />
<img src="decorative-line.png" alt="dekorative Linie" />
```
1.2 Zeitbasierte Medien
1.2.1 Nur-Audio und Nur-Video (Niveau A)
- Audio hat Texttranskript
- Video hat Audiobeschreibung oder Transkript
1.2.2 Untertitel (Niveau A)
- Alle Videos haben synchronisierte Untertitel
- Untertitel sind genau und vollständig
- Sprecheridentifikation enthalten
1.2.3 Audiobeschreibung (Niveau A)
- Video hat Audiobeschreibung für visuelle Inhalte
1.3 Anpassbar
1.3.1 Info und Beziehungen (Niveau A)
- Überschriften verwenden korrekte Tags (h1-h6)
- Listen verwenden ul/ol/dl
- Tabellen haben Kopfzeilen
- Formulareingaben haben Beschriftungen
- ARIA-Landmarken vorhanden
Prüfung:
<!-- Überschriftenhierarchie -->
<h1>Seitentitel</h1>
<h2>Abschnitt</h2>
<h3>Unterabschnitt</h3>
<h2>Weiterer Abschnitt</h2>
<!-- Tabellenkopfzeilen -->
<table>
<thead>
<tr>
<th scope="col">Name</th>
<th scope="col">Preis</th>
</tr>
</thead>
</table>
1.3.2 Sinnvolle Reihenfolge (Niveau A)
- Lesereihenfolge ist logisch
- CSS-Positionierung unterbricht Reihenfolge nicht
- Fokusreihenfolge entspricht visueller Reihenfolge
1.3.3 Sensorische Merkmale (Niveau A)
- Anweisungen verlassen sich nicht nur auf Form/Farbe
- „Klicken Sie auf den roten Button" → „Klicken Sie auf Senden (roter Button)"
1.4 Unterscheidbar
1.4.1 Verwendung von Farbe (Niveau A)
- Farbe ist nicht das einzige Mittel zur Informationsvermittlung
- Links ohne Farbe unterscheidbar
- Fehlerzustände nicht nur farblich
1.4.3 Kontrast (Minimum) (Niveau AA)
- Text: 4,5:1 Kontrastverhältnis
- Großer Text (18pt+): 3:1 Verhältnis
- UI-Komponenten: 3:1 Verhältnis
Tools: WebAIM Kontrastprüfer, axe DevTools
1.4.4 Textgröße ändern (Niveau AA)
- Text auf 200% ohne Verlust vergrößerbar
- Kein horizontales Scrollen bei 320px
- Inhalte fließen korrekt um
1.4.10 Umfluss (Niveau AA)
- Inhalte fließen bei 400% Zoom um
- Kein zweidimensionales Scrollen
- Alle Inhalte bei 320px Breite zugänglich
1.4.11 Nicht-Text-Kontrast (Niveau AA)
- UI-Komponenten haben 3:1 Kontrast
- Fokusindikatoren sichtbar
- Grafische Objekte unterscheidbar
1.4.12 Textabstand (Niveau AA)
- Kein Inhaltsverlust bei erhöhtem Abstand
- Zeilenabstand 1,5x Schriftgröße
- Absatzabstand 2x Schriftgröße
- Zeichenabstand 0,12x Schriftgröße
- Wortabstand 0,16x Schriftgröße
### Bedienbar (Prinzip 2)
```markdown
## 2.1 Tastaturzugänglich
### 2.1.1 Tastatur (Niveau A)
- [ ] Alle Funktionen per Tastatur zugänglich
- [ ] Keine Tastaturfallen
- [ ] Tab-Reihenfolge ist logisch
- [ ] Benutzerdefinierte Widgets tastaturbedienbar
Prüfung:
```javascript
// Benutzerdefinierter Button muss tastaturzugänglich sein
<div role="button" tabindex="0"
onkeydown="if(event.key === 'Enter' || event.key === ' ') activate()">
```
### 2.1.2 Keine Tastaturfalle (Niveau A)
- [ ] Fokus kann von allen Komponenten weg bewegt werden
- [ ] Modale Dialoge sperren Fokus korrekt
- [ ] Fokus kehrt nach Schließen des Modals zurück
## 2.2 Ausreichend Zeit
### 2.2.1 Zeitbegrenzung anpassbar (Niveau A)
- [ ] Sitzungszeitüberschreitungen können verlängert werden
- [ ] Benutzer wird vor Zeitablauf gewarnt
- [ ] Option zum Deaktivieren der automatischen Aktualisierung
### 2.2.2 Pausieren, Stoppen, Ausblenden (Niveau A)
- [ ] Bewegte Inhalte können pausiert werden
- [ ] Automatisch aktualisierte Inhalte können pausiert werden
- [ ] Animationen respektieren prefers-reduced-motion
```css
@media (prefers-reduced-motion: reduce) {
* {
animation: none !important;
transition: none !important;
}
}
```
## 2.3 Anfälle und körperliche Reaktionen
### 2.3.1 Drei Blitze (Niveau A)
- [ ] Keine Inhalte blitzen mehr als 3 Mal/Sekunde
- [ ] Blitzfläche ist klein (<25% Viewport)
## 2.4 Navigierbar
### 2.4.1 Blöcke umgehen (Niveau A)
- [ ] Link zum Überspringen zum Hauptinhalt vorhanden
- [ ] Landmarken definiert
- [ ] Korrekte Überschriftenstruktur
```html
<a href="#main" class="skip-link">Zum Hauptinhalt springen</a>
<main id="main">...</main>
```
### 2.4.2 Seite betitelt (Niveau A)
- [ ] Eindeutige, beschreibende Seitentitel
- [ ] Titel spiegelt Seiteninhalt wider
### 2.4.3 Fokusreihenfolge (Niveau A)
- [ ] Fokusreihenfolge entspricht visueller Reihenfolge
- [ ] tabindex korrekt verwendet
### 2.4.4 Linkzweck (Im Kontext) (Niveau A)
- [ ] Links ergeben auch aus dem Kontext Sinn
- [ ] Kein „klicken Sie hier" oder „mehr lesen" allein
```html
<!-- Schlecht -->
<a href="report.pdf">Hier klicken</a>
<!-- Gut -->
<a href="report.pdf">Download Q4-Verkaufsbericht (PDF)</a>
```
### 2.4.6 Überschriften und Beschriftungen (Niveau AA)
- [ ] Überschriften beschreiben Inhalt
- [ ] Beschriftungen beschreiben Zweck
### 2.4.7 Fokus sichtbar (Niveau AA)
- [ ] Fokusindikator auf allen Elementen sichtbar
- [ ] Benutzerdefinierte Fokus-Stile erfüllen Kontrast
```css
:focus {
outline: 3px solid #005fcc;
outline-offset: 2px;
}
```
### 2.4.11 Fokus nicht verdeckt (Niveau AA) - WCAG 2.2
- [ ] Fokussiertes Element nicht vollständig verborgen
- [ ] Sticky-Header verdecken Fokus nicht
Verständlich (Prinzip 3)
## 3.1 Lesbar
### 3.1.1 Sprache der Seite (Niveau A)
- [ ] HTML lang-Attribut gesetzt
- [ ] Sprache korrekt für Inhalt
```html
<html lang="de">
3.1.2 Sprache von Teilen (Niveau AA)
- Sprachwechsel markiert
<p>Das französische Wort <span lang="fr">bonjour</span> bedeutet Hallo.</p>
3.2 Vorhersehbar
3.2.1 Bei Fokus (Niveau A)
- Kein Kontextwechsel allein durch Fokus
- Keine unerwarteten Pop-ups bei Fokus
3.2.2 Bei Eingabe (Niveau A)
- Kein automatisches Absenden des Formulars
- Benutzer wird vor Kontextwechsel gewarnt
3.2.3 Konsistente Navigation (Niveau AA)
- Navigation konsistent über Seiten hinweg
- Wiederholte Komponenten in gleicher Reihenfolge
3.2.4 Konsistente Bezeichnung (Niveau AA)
- Gleiche Funktion = gleiche Bezeichnung
- Symbole konsistent verwendet
3.3 Eingabehilfe
3.3.1 Fehleridentifikation (Niveau A)
- Fehler klar identifiziert
- Fehlermeldung beschreibt Problem
- Fehler mit Feld verknüpft
<input aria-describedby="email-error" aria-invalid="true" />
<span id="email-error" role="alert">Bitte gültige E-Mail eingeben</span>
3.3.2 Beschriftungen oder Anweisungen (Niveau A)
- Alle Eingaben haben sichtbare Beschriftungen
- Pflichtfelder gekennzeichnet
- Formatierungshinweise gegeben
3.3.3 Fehlerkorrektur (Niveau AA)
- Fehler enthalten Korrekturvorschlag
- Vorschläge sind spezifisch
3.3.4 Fehlervermeidung (Niveau AA)
- Rechtliche/finanzielle Formulare umkehrbar
- Daten vor dem Absenden geprüft
- Benutzer kann vor dem Absenden überprüfen
### Robust (Prinzip 4)
```markdown
## 4.1 Kompatibel
### 4.1.1 Parsen (Niveau A) - Veraltet in WCAG 2.2
- [ ] Gültiges HTML (gute Praxis)
- [ ] Keine doppelten IDs
- [ ] Vollständige Start-/End-Tags
### 4.1.2 Name, Rolle, Wert (Niveau A)
- [ ] Benutzerdefinierte Widgets haben zugängliche Namen
- [ ] ARIA-Rollen korrekt
- [ ] Zustandsänderungen angesagt
```html
<!-- Zugängliche benutzerdefinierte Checkbox -->
<div role="checkbox"
aria-checked="false"
tabindex="0"
aria-labelledby="label">
</div>
<span id="label">Bedingungen akzeptieren</span>
```
### 4.1.3 Statusmeldungen (Niveau AA)
- [ ] Statusaktualisierungen angesagt
- [ ] Live-Regionen korrekt verwendet
```html
<div role="status" aria-live="polite">3 Artikel in den Warenkorb gelegt</div>
<div role="alert" aria-live="assertive">Fehler: Formularübermittlung fehlgeschlagen</div>
```
Automatisierte Tests
// axe-core Integration
const axe = require('axe-core');
async function runAccessibilityAudit(page) {
await page.addScriptTag({ path: require.resolve('axe-core') });
const results = await page.evaluate(async () => {
return await axe.run(document, {
runOnly: {
type: 'tag',
values: ['wcag2a', 'wcag2aa', 'wcag21aa', 'wcag22aa']
}
});
});
return {
violations: results.violations,
passes: results.passes,
incomplete: results.incomplete
};
}
// Playwright-Testbeispiel
test('sollte keine Zugänglichkeitsverstöße haben', async ({ page }) => {
await page.goto('/');
const results = await runAccessibilityAudit(page);
expect(results.violations).toHaveLength(0);
});
# CLI-Tools
npx @axe-core/cli https://example.com
npx pa11y https://example.com
lighthouse https://example.com --only-categories=accessibility
Sanierungsmuster
Behebung: Fehlende Formularbeschriftungen
<!-- Vorher -->
<input type="email" placeholder="E-Mail" />
<!-- Nachher: Option 1 - Sichtbare Beschriftung -->
<label for="email">E-Mail-Adresse</label>
<input id="email" type="email" />
<!-- Nachher: Option 2 - aria-label -->
<input type="email" aria-label="E-Mail-Adresse" />
<!-- Nachher: Option 3 - aria-labelledby -->
<span id="email-label">E-Mail</span>
<input type="email" aria-labelledby="email-label" />
Behebung: Unzureichender Farbkontrast
/* Vorher: 2,5:1 Kontrast */
.text {
color: #767676;
}
/* Nachher: 4,5:1 Kontrast */
.text {
color: #595959;
}
/* Oder Hintergrund hinzufügen */
.text {
color: #767676;
background: #000;
}
Behebung: Tastaturnavigation
// Benutzerdefiniertes Element tastaturzugänglich machen
class AccessibleDropdown extends HTMLElement {
connectedCallback() {
this.setAttribute("tabindex", "0");
this.setAttribute("role", "combobox");
this.setAttribute("aria-expanded", "false");
this.addEventListener("keydown", (e) => {
switch (e.key) {
case "Enter":
case " ":
this.toggle();
e.preventDefault();
break;
case "Escape":
this.close();
break;
case "ArrowDown":
this.focusNext();
e.preventDefault();
break;
case "ArrowUp":
this.focusPrevious();
e.preventDefault();
break;
}
});
}
}
Best Practices
Zu tun
- Früh beginnen - Barrierefreiheit ab der Designphase
- Mit echten Nutzern testen - Menschen mit Behinderungen geben das beste Feedback
- Automatisieren, was möglich ist - 30-50% der Probleme erkennbar
- Semantisches HTML verwenden - Reduziert ARIA-Bedarf
- Muster dokumentieren - Zugängliche Komponentenbibliothek aufbauen
Nicht tun
- Nicht nur auf automatisierte Tests verlassen - Manuelle Tests erforderlich
- ARIA nicht als erste Lösung verwenden - Zuerst natives HTML
- Fokusumrisse nicht ausblenden - Tastaturnutzer brauchen sie
- Zoom nicht deaktivieren - Nutzer müssen vergrößern können
- Farbe nicht allein verwenden - Mehrere Indikatoren nötig

