Dokumentace Pandus SDK
Živé bariéry a co opravit nejdřív
Jak Pandus SDK zachytí bariéry při skutečných návštěvách, propojí je s nálezy skeneru, seřadí opravy, potvrdí je a pošle týdenní souhrn.
Aktualizováno:
Skener ukazuje, co je rozbité v kódu. SDK ukazuje, kde na to skuteční návštěvníci narážejí a kolik jich je. Dohromady dávají pořadí práce podle skutečného provozu a po opravě systém sám ověří, že signál zmizel.
Jak se bariéry zachytí
Každý detektor sleduje stránku v prohlížeči návštěvníka a hlásí stránku, stabilní selektor a kritérium úspěchu WCAG. Nikdy neposílá text, hodnoty polí, ID relace ani klienta. Signály se sčítají za zobrazení v prohlížeči a na našem serveru podle šablony stránky a prvku, takže /product/123 a /product/456 se počítají jako jedna šablona.
| Signál | Jak se pozná | WCAG |
|---|---|---|
| Past fokusu | Tab a Shift+Tab krouží v několika prvcích, Esc nepomůže ven, myš se nepoužila | 2.1.2 |
| Ztracený fokus | Po akci (zavřené okno, odstraněný prvek) je fokus na body stránky | 2.4.3 |
| Neviditelný fokus | Prvek s fokusem vypadá stejně jako bez něj | 2.4.7, 2.4.11 |
| Zakrytý fokus | Přilepená hlavička nebo lišta zakrývá prvek s fokusem | 2.4.11 |
| Skok v pořadí fokusu | Další fokus skáče proti vizuálnímu toku | 2.4.3 |
| Prvek bez sémantiky | Kliknutí na prvek s kurzorem ukazatele, ale bez role, tabindex a názvu | 4.1.2, 2.1.1 |
| Fokus ve skrytém obsahu | Fokus v části s aria-hidden |
4.1.2 |
| Neohlášené chyby formulářů | Neplatná pole bez aria-invalid nebo propojené zprávy; opakované neúspěšné odeslání |
3.3.1, 3.3.3 |
| Přeskupení a zvětšení | Vodorovné posouvání při 320 CSS px nebo po zvětšení; oříznutý text | 1.4.10, 1.4.4 |
| Automatické přehrávání | Video nebo zvuk se spustí bez akce | 1.4.2 |
| Živý axe | axe-core na vzorku skutečných stavů stránky, viz Rozšíření a živý axe | dle pravidla |
| Hlášení bariér | Formulář „Nahlásit bariéru“ propojený se stránkou a jejími signály | — |
Vzteklá a mrtvá kliknutí se ukazují vedle bariér jako nápověda, bez kritéria WCAG. Odkaz „přeskočit na obsah“, který návštěvníci používají, se počítá jako pozitivní signál.
Jeden seznam: co opravit
Co opravit spojuje problémy ze čtyř zdrojů: skener, živí návštěvníci, rozšíření a hlášení bariér. Každý problém má štítky zdrojů. Nález skeneru a živý signál na stejné stránce nebo šabloně, se stejným selektorem a kritériem WCAG se stanou jedním problémem se štítkem „potvrzeno skutečnými návštěvníky: N relací za 7 dní“.
Filtrujte podle stavu, stránky, kritéria WCAG, závažnosti a řešitele; měňte mnoho problémů najednou.
Priorita
Priorita = váha závažnosti × podíl zasažených relací × provoz stránky × koeficient potvrzení (skener a návštěvníci dohromady) × koeficient hlášení bariér. Bariéra v kroku před klíčovou událostí jde nahoru. Nahoře v seznamu je vidět očekávaný dopad, např. „týká se asi 12 % návštěv stránky košíku“. Rady vybírají pravidla a karty pravidel; AI se nepoužívá.
Karta problému
- Co to je a proč je to důležité pro byznys, z karty pravidla v sedmi jazycích.
- Kde se vyskytuje: stránky a šablony s jejich provozem.
- Důkazy: snímek a selektor ze skeneru, graf živých signálů, nahrávky s touto bariérou, výřez heatmapy, zprávy od návštěvníků.
- Jak opravit v Shopify, WooCommerce, PrestaShop, Shoptet a v kódu.
- Stav, řešitel a komentáře týmu.
- Ověřit opravu: skener zkontroluje znovu a sleduje se živý provoz. Ukázat na webu otevře stránku v rozšíření se zvýrazněným prvkem.
Stavy
Otevřeno → řeší se → opraveno → potvrzeno, když živý signál zůstane pod prahem stanovený počet dní, nebo vrátilo se, když se znovu objeví. Problém lze skrýt s důvodem.
Index zdraví
Skóre od 0 do 100 ze skeneru a živých bariér v hlavičce webu, se vzorcem na jedno kliknutí a vývojem.
Obrazovka Živé bariéry
Signály podle typu a stránky s vývojem, mapa klávesnice (kam se lidé dostanou klávesou Tab a kde se zastaví) a předvolby zobrazení jen souhrnně, při nejméně 20 relacích.
Hlášení bariér
Veřejný formulář „Nahlásit bariéru“ se ptá krok za krokem, jednoduchými slovy, s volitelným snímkem. V panelu mají hlášení stavy (nové, řeší se, vyřešeno, spam), propojí se s problémy a nahrávkami stránky a můžete odpovědět návštěvníkovi, který nechal e-mail a dal souhlas, nebo přidat bariéru ručně.
Souhrn a upozornění
Jednou týdně e-mailem a v Telegramu: nové bariéry, co se potvrdilo jako opravené, a výkyvy. Prudký nárůst signálu pošle upozornění hned; práh je v nastavení.
Pandus SDK i skener jsou automatické kontroly, ne úplný audit a ne právní poradenství. SDK na webu nic nemění a nezjišťuje, kteří návštěvníci používají asistivní technologie.