Barrierefreiheit von Webanwendungen testen: was anders ist als bei einer Website
Eine Webanwendung wird gegen denselben Standard geprüft wie eine Website, WCAG 2.2 AA, aber ihre Probleme verstecken sich in Zuständen, die ein Crawler nie erreicht: ein Dialog, eine gefilterte Tabelle hinter dem Login. Ein brauchbarer Plan hat vier Schichten: automatische Prüfungen in CI auf echten Zuständen, Prüfungen eingeloggter Screens, ein kurzes Tastaturskript und Live-Signale von Nutzern.
Von Vadym Liubyvyi, Gründer von Pandus · Aktualisiert am 21. Oktober 2026 · Lesezeit: 5 Min. · Wie wir unsere Ratgeber schreiben und prüfen
Auf einer Website ist die Seite die Einheit: Man öffnet eine URL, der Inhalt ist da, ein Checker liest ihn. In einer Webanwendung ist der Zustand die Einheit. Dieselbe URL zeigt eine leere Liste, einen Ladekreis, eine gefilterte Tabelle oder einen Fehler, je nachdem, was der Nutzer getan hat. Die Login-Seite ist das Einzige, was ein Crawler sieht, und dort sind die Probleme selten.
Dieser Leitfaden ist für Teams, die SaaS-Produkte, Portale und interne Tools bauen. Er setzt voraus, dass Sie die WCAG-2.2-Checkliste kennen und wissen wollen, wohin Sie sie richten.
Wo Webanwendungen scheitern
Sechs Stellen machen die meisten Blocker aus, die wir in Anwendungen sehen:
- Routenwechsel ohne Fokusführung. In einer Single-Page-Anwendung ändert sich die URL, der Inhalt ändert sich, aber der Fokus bleibt auf einem Link, den es nicht mehr gibt. Ein Screenreader-Nutzer hört nichts. Die Lösung: den Fokus auf die Überschrift oder die Hauptregion der neuen Ansicht setzen und den Dokumenttitel aktualisieren.
- Dialoge. Ein Dialog muss beim Öffnen den Fokus übernehmen, Tab innen halten, mit Escape schließen und den Fokus an das Element zurückgeben, das ihn geöffnet hat. Die meisten eigenen Dialoge scheitern an mindestens einem Punkt; siehe das Muster für modale Dialoge.
- Toasts und Live-Updates. Eine Meldung, die drei Sekunden in der Ecke erscheint, ist für einen Screenreader unsichtbar, wenn sie nicht in einer Live-Region steht. Statusmeldungen sind ein WCAG-2.2-Kriterium (4.1.3).
- Eigene Bedienelemente. Comboboxen, Datumsauswahlen, Schieberegler und Schalter aus
div-Elementen haben weder Rolle noch Namen noch Tastaturverhalten, solange niemand sie ergänzt. Das Muster für Select und Combobox zeigt das erwartete Verhalten. - Tabellen und Listen mit Aktionen. Eine Reihe von Icon-Buttons (bearbeiten, löschen, herunterladen) ohne zugänglichen Namen liest sich als „Schaltfläche, Schaltfläche, Schaltfläche“. Virtualisierte Listen, die nur die sichtbaren Zeilen rendern, verwirren Screenreader, die die ganze Liste lesen.
- Formulare mit Inline-Validierung. Fehler, die neben einem Feld erscheinen, aber nicht damit verknüpft sind, oder angekündigt werden, bevor der Nutzer fertig getippt hat. Das Muster für Formularfehler beschreibt die Verknüpfung.
Nichts davon ist exotisch. Es sind die normalen Bausteine einer Anwendung, und jeder davon ist für eine Prüfung unsichtbar, die auf der Login-Seite läuft.
Schicht 1: automatische Prüfungen in CI auf echten Zuständen
Lassen Sie die offene axe-core-Engine in Ihren End-to-End-Tests laufen, in dem Zustand, den Sie prüfen wollen: nach dem Einloggen, nach dem Öffnen des Dialogs, nach dem Anwenden des Filters. Playwright mit @axe-core/playwright ist das übliche Setup; unser Leitfaden zu Barrierefreiheitstests mit Playwright enthält den Code und das Regelset, das zum Pandus-Scanner passt, damit CI und die wöchentliche Prüfung übereinstimmen.
Drei Gewohnheiten machen das nützlich statt laut:
- Den Build nur bei serious und critical scheitern lassen; der Rest bleibt Bericht.
- Zustände statt Seiten testen: ein Test pro Dialog, pro leerem Zustand, pro Fehlerzustand.
- Dokumenttitel und Fokus nach jedem Routenwechsel im selben Test prüfen.
Schicht 2: die eingeloggten Screens im Browser
CI deckt ab, was Sie zu testen beschlossen haben. Die Pandus-Browser-Erweiterung deckt ab, was Sie gerade offen haben: eine Staging-Umgebung, den Admin-Bereich, das Konto eines Kunden mit echten Daten. Sie führt dieselben Regeln aus, erklärt jedes Problem in klaren Worten und kopiert eine Notiz für den Entwickler oder einen Prompt für einen KI-Assistenten. Die Werkzeuge für Tab-Reihenfolge und Fokus zeigen die Reihenfolge, der Tastaturnutzer begegnen werden, und das ist in einer Anwendung die häufigste Überraschung.
Schicht 3: zehn Minuten mit der Tastatur
Die Automatik beurteilt nicht, ob die Reihenfolge Sinn ergibt oder ob der Toast gehört wurde. Ein kurzes Skript tut es, und es passt in ein Sprint-Review:
- Maus abstecken, Login-Seite öffnen und nur mit Tab und Enter anmelden. Sehen Sie bei jedem Schritt, wo Sie sind?
- Den Hauptdialog des Produkts öffnen. Wandert der Fokus hinein? Schließt Escape ihn und bringt Sie zurück?
- Eine Erfolgsmeldung und einen Fehler auslösen. Werden sie mit laufendem Screenreader (NVDA, VoiceOver) angekündigt?
- Die Haupttabelle oder -liste nutzen: sortieren, filtern, eine Zeile öffnen, eine Zeilenaktion ausführen. Brauchten Sie irgendwo die Maus?
- Eine Route über die Navigation wechseln. Wo ist jetzt der Fokus, und was sagt der Titel?
Wo Sie hängen geblieben sind, bleiben auch Nutzer mit Tastatur, Schalter oder Screenreader hängen. Schreiben Sie die fünf Antworten auf; sie sind der manuelle Teil Ihrer Seite zur Barrierefreiheit.
Schicht 4: Live-Signale von echten Nutzern
Die drei Schichten oben prüfen, was Sie zu prüfen beschlossen haben. Das Pandus SDK meldet, was Nutzer tatsächlich getroffen hat: Tastaturfokus auf einem Screen gefangen, Fokus nach dem Schließen eines Dialogs verloren, ein Bedienelement ohne Namen, auf das Leute immer wieder geklickt haben, ein Formularfehler, der nie angekündigt wurde, ein Layout, das beim Zoomen zerbrach. Jedes Signal trägt Seite, Element und WCAG-Kriterium, und die Signale werden gezählt, sodass die erste Korrektur die ist, die die meisten Nutzer trifft. Auf einer Stichprobe von Seitenaufrufen lässt das SDK außerdem axe-core auf dem echten Zustand der Anwendung laufen, jeder Text ersetzt, bevor etwas den Browser verlässt.
Nach einer Korrektur prüft der Scanner erneut, und das Live-Signal wird eine festgelegte Zahl von Tagen beobachtet. „Von echten Besuchern bestätigt“ ist ein besserer Status als „geschlossen“.
Was aufzuschreiben ist
Käufer von Webanwendungen verlangen Nachweise. Halten Sie drei Dinge aktuell:
- Eine Seite zur Barrierefreiheit mit dem Datum der letzten Prüfung, dem Standard (WCAG 2.2 AA), den bekannten Einschränkungen und einem Weg, eine Barriere zu melden. Der Leitfaden zur Erklärung zur Barrierefreiheit hat eine Vorlage; Pandus entwirft sie aus einem Fragebogen.
- Einen Accessibility Conformance Report im VPAT-Format, wenn öffentliche Stellen oder große Organisationen zu Ihren Kunden gehören. Pandus erzeugt in Agency-Tarifen einen Entwurf aus der automatischen Prüfung; die manuellen Spalten brauchen einen Menschen.
- Die Liste der offenen Probleme mit Verantwortlichen und Terminen, exportiert nach Jira oder GitHub, damit der nächste Sprint sie hat.
Automatische Prüfungen, die Erweiterung und das SDK finden einen Teil der Probleme; das Tastaturskript und eine manuelle Prüfung finden den Rest. Wir sagen in jedem Bericht, dass es eine automatische Prüfung und kein vollständiges Audit ist, und nichts hier ist Rechtsberatung.
Weitere Artikel
Ratgeber und Tools
- Barrierefreiheit testen mit Playwright: WCAG-Prüfungen in Ihrer Test-Suite
- Barrierefreiheit, SEO und Ladezeit jeder Seite mit einem Klick
- Barrierefreier modaler Dialog
Hilfeartikel
-
Browser-Erweiterung mit dem Konto verbinden
Seiten hinter einem Login prüfen, das Ergebnis in der Website speichern und die ganze Website aus dem Browser prüfen.
-
API-Tokens und Webhooks
Token erstellen, die API aus eigenen Werkzeugen aufrufen und eine signierte Nachricht erhalten, wenn eine Prüfung endet.