Pandus SDK Dokumentation
Live-Barrieren und was zuerst beheben
Wie das Pandus SDK Barrieren in echten Besuchen erkennt, sie mit Scanner-Funden verbindet, die Reihenfolge der Korrekturen bestimmt, Korrekturen bestätigt und einen Wochenbericht sendet.
Aktualisiert:
Ein Scanner zeigt, was im Code kaputt ist. Das SDK zeigt, wo echte Besucher darauf stoßen und wie viele. Zusammen ergibt das eine Arbeitsreihenfolge nach echtem Traffic, und nach einer Korrektur prüft das System selbst, dass das Signal verschwunden ist.
Wie Barrieren erkannt werden
Jeder Detektor beobachtet die Seite im Browser des Besuchers und meldet die Seite, einen stabilen Selektor und das WCAG-Erfolgskriterium. Er sendet nie Text, Feldwerte, eine Sitzungs- oder Client-ID. Signale werden je Seitenaufruf im Browser und auf unserem Server je Seitenvorlage und Element zusammengefasst, sodass /product/123 und /product/456 als eine Vorlage zählen.
| Signal | Wie es bemerkt wird | WCAG |
|---|---|---|
| Fokusfalle | Tab und Umschalt+Tab kreisen in wenigen Elementen, Esc führt nicht hinaus, die Maus wurde nicht benutzt | 2.1.2 |
| Verlorener Fokus | Nach einer Aktion (Dialog geschlossen, Element entfernt) liegt der Fokus auf dem Seitenkörper | 2.4.3 |
| Unsichtbarer Fokus | Das fokussierte Element sieht genauso aus wie ohne Fokus | 2.4.7, 2.4.11 |
| Verdeckter Fokus | Eine feste Kopfzeile oder ein Banner verdeckt das fokussierte Element | 2.4.11 |
| Sprung in der Fokusreihenfolge | Der nächste Fokus springt gegen den visuellen Fluss | 2.4.3 |
| Bedienelement ohne Semantik | Klick auf ein Element mit Zeiger-Cursor, aber ohne Rolle, tabindex und Namen | 4.1.2, 2.1.1 |
| Fokus in verborgenem Inhalt | Fokus in einem Bereich mit aria-hidden |
4.1.2 |
| Nicht angekündigte Formularfehler | Ungültige Felder ohne aria-invalid oder verknüpfte Meldung; wiederholte erfolglose Sendungen |
3.3.1, 3.3.3 |
| Umbruch und Zoom | Seitliches Scrollen bei 320 CSS-Pixel oder beim Zoomen; abgeschnittener Text | 1.4.10, 1.4.4 |
| Autoplay | Video oder Audio mit Ton startet ohne Aktion | 1.4.2 |
| Live-axe | axe-core auf einer Stichprobe echter Seitenzustände, siehe Browser-Erweiterung und Live-axe | je Regel |
| Barrieremeldungen | Das Formular „Barriere melden“, verknüpft mit der Seite und ihren Signalen | — |
Wut- und tote Klicks erscheinen als Hinweis neben den Barrieren, ohne WCAG-Kriterium. Ein Skip-Link, den Besucher nutzen, zählt als positives Signal.
Eine Liste: was beheben
Was beheben vereint Probleme aus vier Quellen: Scanner, Live-Besucher, Erweiterung und Barrieremeldungen. Jedes Problem zeigt Abzeichen seiner Quellen. Ein Scanner-Fund und ein Live-Signal auf derselben Seite oder Vorlage, demselben Selektor und WCAG-Kriterium werden ein Problem mit dem Abzeichen „von echten Besuchern bestätigt: N Sitzungen in 7 Tagen“.
Filtern Sie nach Status, Seite, WCAG-Kriterium, Schwere und zuständiger Person; ändern Sie viele Probleme auf einmal.
Priorität
Priorität = Gewicht der Schwere × Anteil betroffener Sitzungen × Traffic der Seite × Bestätigungsfaktor (Scanner und Besucher zusammen) × Faktor der Barrieremeldungen. Eine Barriere im Schritt vor einem Schlüsselereignis rückt nach oben. Oben in der Liste steht die erwartete Wirkung, etwa „betrifft etwa 12 % der Besuche der Warenkorbseite“. Regeln und Regelkarten wählen die Hinweise; KI ist nicht beteiligt.
Die Problemkarte
- Was es ist und warum es fürs Geschäft zählt, aus der Regelkarte in sieben Sprachen.
- Wo es auftritt: Seiten und Vorlagen mit ihrem Traffic.
- Belege: Screenshot und Selektor des Scanners, der Verlauf der Live-Signale, Aufzeichnungen mit dieser Barriere, ein Heatmap-Ausschnitt, Meldungen von Besuchern.
- Wie man es in Shopify, WooCommerce, PrestaShop, Shoptet und im Code behebt.
- Status, zuständige Person und Kommentare des Teams.
- Korrektur prüfen: Der Scanner prüft erneut und der Live-Traffic wird beobachtet. Auf der Website zeigen öffnet die Seite in der Erweiterung mit hervorgehobenem Element.
Status
Offen → in Arbeit → behoben → bestätigt, wenn das Live-Signal die festgelegte Zahl von Tagen unter der Schwelle bleibt, oder zurückgekehrt, wenn es wiederkommt. Ein Problem lässt sich mit Begründung ausblenden.
Gesundheitsindex
Eine Zahl von 0 bis 100 aus Scanner und Live-Barrieren, im Kopf der Website, mit der Formel einen Klick entfernt und einem Verlauf.
Ansicht Live-Barrieren
Signale nach Typ und Seite mit Verläufen, die Tastaturkarte (wie weit Menschen mit Tab kommen und wo sie stoppen) und Darstellungseinstellungen nur aggregiert, ab 20 Sitzungen.
Barrieremeldungen
Das öffentliche Formular „Barriere melden“ fragt schrittweise und in einfachen Worten, mit optionalem Screenshot. Im Dashboard haben Meldungen Status (neu, in Arbeit, gelöst, Spam), sind mit Problemen und Aufzeichnungen der Seite verknüpft, und Sie können einem Besucher antworten, der eine E-Mail hinterlassen und zugestimmt hat, oder eine Barriere von Hand anlegen.
Wochenbericht und Warnungen
Einmal pro Woche per E-Mail und Telegram: neue Barrieren, bestätigte Korrekturen und Spitzen. Ein plötzlicher Anstieg eines Signals löst sofort eine Warnung aus; die Schwelle steht in den Einstellungen.
Das Pandus SDK und der Scanner sind automatische Prüfungen, kein vollständiges Audit und keine Rechtsberatung. Das SDK verändert nichts an Ihrer Website und stellt nicht fest, welche Besucher assistive Technologien nutzen.