Dokumentacja Pandus SDK
Bariery na żywo i co naprawić najpierw
Jak Pandus SDK wykrywa bariery w prawdziwych wizytach, łączy je z wynikami skanera, ustala kolejność poprawek, potwierdza je i wysyła tygodniowe podsumowanie.
Zaktualizowano:
Skaner pokazuje, co jest zepsute w kodzie. SDK pokazuje, gdzie prawdziwi odwiedzający na to trafiają i ilu ich jest. Razem dają kolejność pracy według prawdziwego ruchu, a po poprawce system sam sprawdza, że sygnał zniknął.
Jak wykrywane są bariery
Każdy detektor obserwuje stronę w przeglądarce odwiedzającego i zgłasza stronę, stabilny selektor i kryterium sukcesu WCAG. Nigdy nie wysyła tekstu, wartości pól, identyfikatora sesji ani klienta. Sygnały są sumowane na wyświetlenie strony w przeglądarce, a na naszym serwerze według szablonu strony i elementu, więc /product/123 i /product/456 liczą się jako jeden szablon.
| Sygnał | Jak jest zauważany | WCAG |
|---|---|---|
| Pułapka fokusu | Tab i Shift+Tab krążą po kilku elementach, Esc nie wyprowadza, mysz nie była używana | 2.1.2 |
| Utracony fokus | Po działaniu (zamknięte okno, usunięty element) fokus jest na body strony | 2.4.3 |
| Niewidoczny fokus | Element z fokusem wygląda tak samo jak bez niego | 2.4.7, 2.4.11 |
| Zasłonięty fokus | Przyklejony nagłówek lub baner zasłania element z fokusem | 2.4.11 |
| Skok kolejności fokusu | Kolejny fokus skacze wbrew wizualnemu porządkowi | 2.4.3 |
| Kontrolka bez semantyki | Kliknięcie elementu z kursorem wskaźnika, ale bez roli, tabindex i nazwy | 4.1.2, 2.1.1 |
| Fokus w ukrytej treści | Fokus w części z aria-hidden |
4.1.2 |
| Nieogłoszone błędy formularza | Nieprawidłowe pola bez aria-invalid lub powiązanego komunikatu; powtarzane nieudane wysyłki |
3.3.1, 3.3.3 |
| Przepływ i powiększenie | Przewijanie w poziomie przy 320 px CSS lub po powiększeniu; ucięty tekst | 1.4.10, 1.4.4 |
| Autoodtwarzanie | Wideo lub audio z dźwiękiem startuje bez działania | 1.4.2 |
| axe na żywo | axe-core na próbce prawdziwych stanów strony, zobacz Rozszerzenie i axe na żywo | wg reguły |
| Zgłoszenia barier | Formularz „Zgłoś barierę”, powiązany ze stroną i jej sygnałami | — |
Kliknięcia ze złości i martwe kliknięcia są pokazywane obok barier jako wskazówka, bez kryterium WCAG. Link „przejdź do treści”, z którego korzystają odwiedzający, liczy się jako sygnał pozytywny.
Jedna lista: co naprawić
Co naprawić łączy problemy z czterech źródeł: skaner, odwiedzający na żywo, rozszerzenie i zgłoszenia barier. Każdy problem ma plakietki źródeł. Wynik skanera i sygnał na żywo z tej samej strony lub szablonu, selektora i kryterium WCAG stają się jednym problemem z plakietką „potwierdzone przez prawdziwych odwiedzających: N sesji w 7 dni”.
Filtruj według statusu, strony, kryterium WCAG, wagi i osoby odpowiedzialnej; zmieniaj wiele problemów naraz.
Priorytet
Priorytet = waga problemu × udział dotkniętych sesji × ruch strony × współczynnik potwierdzenia (skaner i odwiedzający razem) × współczynnik zgłoszeń barier. Bariera na kroku przed zdarzeniem kluczowym idzie w górę. Na górze listy widać oczekiwany efekt, np. „dotyczy ok. 12 % wizyt na stronie koszyka”. Porady wybierają reguły i karty reguł; AI nie bierze w tym udziału.
Karta problemu
- Co to jest i dlaczego ważne dla biznesu, z karty reguły w siedmiu językach.
- Gdzie występuje: strony i szablony z ich ruchem.
- Dowody: zrzut ekranu i selektor ze skanera, wykres sygnałów na żywo, nagrania z tą barierą, fragment mapy ciepła, wiadomości od odwiedzających.
- Jak naprawić w Shopify, WooCommerce, PrestaShop, Shoptet i w kodzie.
- Status, osoba odpowiedzialna i komentarze zespołu.
- Sprawdź poprawkę: skaner sprawdza ponownie, a ruch na żywo jest obserwowany. Pokaż na stronie otwiera stronę w rozszerzeniu z wyróżnionym elementem.
Statusy
Otwarte → w toku → naprawione → potwierdzone, gdy sygnał na żywo pozostaje poniżej progu przez ustaloną liczbę dni, albo wróciło, gdy pojawia się znowu. Problem można ukryć z podaniem powodu.
Indeks zdrowia
Wynik od 0 do 100 ze skanera i barier na żywo, w nagłówku strony, ze wzorem o jedno kliknięcie i trendem.
Ekran barier na żywo
Sygnały według typu i strony z trendami, mapa klawiatury (jak daleko ludzie docierają klawiszem Tab i gdzie się zatrzymują) oraz preferencje wyświetlania tylko zbiorczo, przy co najmniej 20 sesjach.
Zgłoszenia barier
Publiczny formularz „Zgłoś barierę” pyta krok po kroku, prostymi słowami, z opcjonalnym zrzutem ekranu. W panelu zgłoszenia mają statusy (nowe, w toku, rozwiązane, spam), łączą się z problemami i nagraniami strony, a Ty możesz odpowiedzieć odwiedzającemu, który zostawił e-mail i wyraził zgodę, albo dodać barierę ręcznie.
Podsumowanie i alerty
Raz w tygodniu, e-mailem i w Telegramie: nowe bariery, co potwierdzono jako naprawione i skoki. Nagły wzrost sygnału od razu wysyła alert; próg jest w ustawieniach.
Pandus SDK i skaner to kontrole automatyczne, nie pełny audyt i nie porada prawna. SDK niczego nie zmienia na stronie i nie ustala, którzy odwiedzający korzystają z technologii asystujących.