Loheide-eu-mitarbeiterplatt.../docs/ACCESSIBILITY.md
Friederich Loheide f8f6a4ba2b
Some checks failed
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 5m58s
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 6m45s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 7m4s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 6m47s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 14m39s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 14m39s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 10m45s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 10m52s
CI / Bekannte Sicherheitslücken in Paketen (pull_request) Successful in 1m16s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m49s
Barrierefreiheit nach WCAG 2.1 AA (0.37.0)
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-27 15:35:34 +00:00

38 lines
1.6 KiB
Markdown

# Barrierefreiheit
Ziel ist WCAG 2.1 AA (entspricht BITV 2.0) für das Portal. Das Backend (Filament) ist nicht Teil der Prüfung.
## Was das Portal mitbringt
- „Zum Inhalt springen“ als erster Tab-Stopp auf jeder Seite
- Sichtbarer Fokusrahmen für alle bedienbaren Elemente
- Systemeinstellung „Bewegung reduzieren“ schaltet Animationen ab
- Helles und dunkles Design mit geprüften Kontrasten, Hausfarbe mit automatisch lesbarer Textfarbe
- Vorlesen (Sprachausgabe des Geräts) und Leichte Sprache für Beiträge und Seiten
- Knöpfe, die auf dem Handy nur ein Symbol zeigen, behalten ihre Beschriftung für Screenreader
## Prüfen
Automatisch mit axe-core (findet etwa ein Drittel aller möglichen Probleme):
```bash
A11Y_BASE=http://127.0.0.1:8765 A11Y_EMAIL=… A11Y_PASSWORD=… npm run a11y
A11Y_DARK=1 npm run a11y # dunkles Design
A11Y_MOBILE=1 npm run a11y # Handy-Breite
A11Y_PATHS=/termine/1,/ideen/1 npm run a11y # bestimmte Seiten
```
Stand 0.37.0: 0 Verstöße auf allen geprüften Seiten (hell, dunkel, Handy).
Von Hand bei neuen Oberflächen:
- Alles mit der Tastatur erreichbar (Tab, Enter, Leertaste, Esc schließt Dialoge)?
- Reihenfolge und Überschriften sinnvoll? Bilder mit Alternativtext, dekorative Symbole `aria-hidden`?
- Bei 200 % Zoom nutzbar, kein waagerechtes Scrollen?
- Mit Screenreader (NVDA, VoiceOver) einmal durchgehen.
## Für Redaktionen
Barrierefreiheit hängt auch vom Inhalt ab: Alternativtexte für Bilder, echte Überschriften statt fett
gesetzter Zeilen, aussagekräftige Linktexte („Antrag herunterladen“ statt „hier“), keine Informationen
nur über Farbe.