Jak číst přístupnostní nálezy

Kódy, které začínají A11Y-, pocházejí z modulu přístupnosti. Na rozdíl od ostatních nálezů auditu je nevymýšlíme my. Jsou to pravidla nástroje axe-core, otevřeného a v oboru nejrozšířenějšího, který stránku prochází v prohlížeči a hledá porušení konkrétních kritérií.

Proto pro ně v tomhle manuálu nenajdete stránku na každý kód. Autoři axe udržují vlastní, průběžně aktualizovaný popis každého pravidla a naše kopie by byla horší a časem by přestala platit. U každého takového nálezu v reportu je odkaz přímo na oficiální popis.

Co v té dokumentaci ale nenajdete, je způsob, jak nálezy číst. Tohle je ta chybějící část.

Nález na jedné stránce skoro nikdy neznamená jednu stránku

Tohle je zdaleka nejdůležitější věta celé stránky. Audit prochází vzorek vašeho webu, ale stejná chyba obvykle nesedí na jedné adrese, ale v šabloně. V hlavičce, v patičce, v kartě produktu, ve formuláři, v komponentě navigace.

Praktický důsledek: když report ukáže A11Y-color-contrast na pěti stránkách, neopravujte pět stránek. Podívejte se, co mají společné. Tlačítko s nedostatečným kontrastem v patičce je jeden řádek v CSS a tisíc opravených stránek naráz.

Platí to i obráceně a je fér to říct: absence nálezu neznamená, že je web v pořádku. Vzorek je vzorek. Šablona, na kterou jsme nenarazili, zůstala neprohlédnutá.

Co znamenají úrovně A, AA a AAA

Pravidla se vážou na kritéria normy WCAG (Web Content Accessibility Guidelines) od konsorcia W3C. Ta jsou rozdělená do tří úrovní podle náročnosti:

Prakticky: cílem není „splnit všechno“. Cílem je úroveň AA. Tu vyžadují dvě různé evropské směrnice, které se často slévají do jedné: 2016/2102 u webů veřejného sektoru a 2019/882 (EAA) u řady komerčních služeb, vymahatelná od 28. června 2025. Obě odkazují na normu EN 301 549, a tady je detail, který stojí za přesnost: referenční je pořád verze v3.2.1, která stojí na WCAG 2.1, ne na 2.2. Verze v4.1.1 s WCAG 2.2 vyšla 2. 9. 2026, ale závazná bude až poté, co ji Komise uvede v Úředním věstníku EU. Vymahatelné je tedy dnes AA podle WCAG 2.1; kritéria, která přibyla až ve 2.2, mezi ně nepatří. Proto vám ukazujeme tři čísla vedle sebe (podle WCAG 2.0, 2.1 a 2.2) a nesléváme je do jednoho: každé odpovídá jinému předpisu a hlavní „Skóre přístupnosti“ je řádek WCAG 2.1 AA. Nálezy na úrovni A opravujte přednostně, AAA berte jako nadstavbu.

Co automatický test najít nemůže

Tohle je mez, kterou je potřeba znát, než si někdo splete zelený výsledek s přístupným webem. Automatický test zachytí jen část skutečných problémů, totiž ty, které jdou posoudit ze značky a ze stylů. Kolik přesně, záleží na tom, co se počítá, a čísla se liší víc, než se obvykle přiznává: v oboru se běžně uvádí 20–30 %, což je podíl kritérií úspěchu WCAG, která jde ověřit strojově. Deque na 13 tisících stránek a bezmála 300 tisících nálezech naměřila 57 %, ale počítala objem nalezených problémů, ne kritérií, a je to výrobce axe, tedy nástroje, který používáme i my. Obě čísla jsou pravdivá, každé měří něco jiného. Podstatné je to společné: zbytek vyžaduje člověka.

• Jestli alternativní text dává smysl. alt="obrazek" projde jako vyplněný. Že nikomu nepomůže, pozná jen člověk.
• Jestli je pořadí procházení tabulátorem logické. Nástroj ověří, že se na prvky dá dostat; že cesta dává smysl, ne.
• Jestli titulky u videa odpovídají zvuku.
• Jestli formulář srozumitelně vysvětlí chybu, kterou uživatel udělal.
• Jestli se dá web ovládat jen klávesnicí od začátku do konce. To zjistíte tak, že odložíte myš a zkusíte to.

Nulový počet nálezů tedy znamená „neprošli jsme na nic, co umíme změřit“, ne „web je přístupný“. Říkáme to rovnou, protože opak by byl nejdražší nepravda v celém reportu.

Měříme ve dvou šířkách okna: 1280 px a 390 px. Není to detail, protože část problémů existuje jen v jednom z rozvržení. Typicky vodorovně posuvná tabulka, ke které se na mobilu nedá dostat klávesnicí: na široké obrazovce se celá vejde a nástroj nemá co hlásit, na úzké vznikne posuvná oblast, kterou uživatel klávesnice neovládne. Nález, který vidíte, proto nemusí jít reprodukovat na vašem monitoru; zkuste okno zúžit.

V jakém pořadí to opravovat

Když je nálezů hodně, pomáhá jednoduché pravidlo: jděte podle toho, co komu doopravdy brání, ne podle počtu výskytů.

1. Cokoli, co znemožňuje dokončit úkol. Formulář, který se nedá odeslat klávesnicí, košík bez popisků polí, přihlášení bez přístupného chybového hlášení.
2. Chybějící textové alternativy u obsahových obrázků a odkazů. Tady se ztrácí informace, ne pohodlí.
3. Barevný kontrast. Týká se všech, koho někdy oslnilo slunce na displeji, tedy všech.
4. Struktura nadpisů a orientační body stránky. Podle nich se po stránce pohybuje uživatel čtečky (souvisí i s naším STR-01).
5. Zbytek.

A jedna poznámka na závěr, protože se na ni v technických auditech zapomíná: přístupnost není o normě, je o lidech. Alternativní text, kontrast a ovládání klávesnicí jsou jediné věci v celém auditu, které dlužíte konkrétním návštěvníkům, ne algoritmu. Zbytek reportu se zabývá tím, jak vám rozumí stroje.