Kontrola přístupnosti omezená na obsah stránky skryje vady společného rámu
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Testy přístupnosti byly zelené. Když se kontrola pustila na celé stránky celé administrace, měla nález úrovně „serious“ každá stránka: přes sto různých prvků – nízký kontrast tlumených textů, tlačítka a výběry bez názvu, editor textu bez názvu, odkazy rozlišené jen barvou.
Root cause
Sekce “Root cause”Dvě omezení testu, každé samo o sobě rozumné:
- Kontrola byla omezená na obsah (
include: "main") s poznámkou „společný rám má vlastní starší nálezy“. Výjimka zůstala a rám nikdo nezměřil. Jeho vady (nadpisy skupin v menu, tlačítko účtu bez názvu na mobilu) se přitom opakují na každé stránce. - Stránky byly v testu vyjmenované ručně a jen ty, na kterých se zrovna pracovalo. Ostatní neměly kontrolu vůbec.
Třetí slabina: detailní stránky bez záznamu v testovací databázi se tiše přeskočily – a právě na nich byly další vady.
// skrývá rám i všechny stránky mimo seznamawait checkA11y(page, "stranka-x", { include: "main" });Fix
Sekce “Fix”- Test si seznam stránek čte ze zdrojů (projde adresář s
page.tsx), takže nová stránka je v kontrole automaticky. - Kontroluje celou stránku na dvou šířkách.
- Detailní stránky potřebují záznam: test si chybějící záznamy zakládá sám a stránka bez záznamu je selhání, ne přeskočení.
- Stavy „neaktivní / skryto / nezveřejněno“ mají vlastní fixtury.
- Nálezy se sbírají přes všechny stránky a vypíšou najednou, aby jedna vada nezakryla ostatní.
Opravy samotné byly mechanické: tmavší odstín tlumeného textu, aria-label u ikonových tlačítek a výběrů bez popisku, název editoru, podtržení odkazů v textu, tabIndex a název u posuvných oblastí.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -rn "include:" tests | grep -i a11yagrep -rn "exclude(" tests– každé omezení kontroly prověřit. Jednorázově pustit kontrolu bez omezení přes všechny stránky a spočítat nálezy podle prvku, ne podle stránky. - Anti-pattern: výjimka „to je starší dluh“ bez úkolu a termínu; ručně psaný seznam stránek; tiché přeskočení stránky bez dat.
- Lepší přístup: seznam stránek ze zdrojů, celá stránka, vlastní fixtury pro detail a pro neobvyklé stavy, sběr všech nálezů v jednom běhu.