# Barrierefreiheit von Webanwendungen testen: was anders ist als bei einer Website
URL: https://pandus.online/de/barrierefreiheit-testen-webanwendung
Updated: 2026-10-21

Barrierefreiheit einer Webanwendung oder eines SaaS testen: Zustände, die ein Crawler nicht erreicht, axe in CI, Prüfungen hinter dem Login, Tastaturskript und Live-Signale.

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](https://pandus.online/de/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:

1. **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.
2. **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](https://pandus.online/de/barrierefreier-modaler-dialog).
3. **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).
4. **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](https://pandus.online/de/barrierefreies-dropdown-combobox) zeigt das erwartete Verhalten.
5. **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.
6. **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](https://pandus.online/de/barrierefreie-formular-fehlermeldungen) 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](https://pandus.online/de/barrierefreiheit-testen-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](https://pandus.online/de/barrierefreiheit-pruefen-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:

1. Maus abstecken, Login-Seite öffnen und nur mit Tab und Enter anmelden. Sehen Sie bei jedem Schritt, wo Sie sind?
2. Den Hauptdialog des Produkts öffnen. Wandert der Fokus hinein? Schließt Escape ihn und bringt Sie zurück?
3. Eine Erfolgsmeldung und einen Fehler auslösen. Werden sie mit laufendem Screenreader (NVDA, VoiceOver) angekündigt?
4. Die Haupttabelle oder -liste nutzen: sortieren, filtern, eine Zeile öffnen, eine Zeilenaktion ausführen. Brauchten Sie irgendwo die Maus?
5. 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](https://pandus.online/de/barrierefreiheit-analyse-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](https://pandus.online/de/barrierefreiheitserklaerung) hat eine Vorlage; Pandus entwirft sie aus einem Fragebogen.
- **Einen Accessibility Conformance Report** im [VPAT-Format](https://pandus.online/de/vpat-barrierefreiheit), 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.

Q: Kann ein Online-Checker meine Webanwendung prüfen?
A: Nur die Seiten, die er ohne Anmeldung erreicht, in ihrem Anfangszustand. Für die Anwendung selbst brauchen Sie eine Prüfung dort, wo der Zustand ist: in CI mit einem Browser, der sich anmeldet, in der Browser-Erweiterung auf dem offenen Screen oder im Browser der Nutzer mit dem SDK.

Q: Wie viel findet die Automatik in einer Webanwendung?
A: Automatische Regeln finden einen Teil der Probleme, wie bei einer Website: Kontrast, Namen, Beschriftungen, Rollen. Fokusreihenfolge, Fokusführung in Dialogen und bei Routenwechseln und ob ein Toast angekündigt wird, brauchen einen Menschen mit Tastatur und Screenreader.

Q: Wo scheitern eigene Komponenten am häufigsten?
A: Dialoge, die den Fokus nicht fangen und zurückgeben, Datumsauswahlen und Comboboxen, die nur mit der Maus funktionieren, Tabellen mit Icon-Buttons ohne Namen und Toasts, die verschwinden, bevor jemand sie hört.

Q: Brauchen wir einen VPAT für eine Webanwendung?
A: Wenn Sie an öffentliche Stellen oder große Organisationen verkaufen, fragen Käufer nach einem Accessibility Conformance Report im VPAT-Format. Pandus erzeugt in Agency-Tarifen einen Entwurf aus der automatischen Prüfung; ein vollständiger ACR braucht eine manuelle Prüfung.
