Přeskočit na obsah

Kontrola přístupnosti omezená na obsah stránky skryje vady společného rámu

import { Aside } from ‘@astrojs/starlight/components’;

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.

Dvě omezení testu, každé samo o sobě rozumné:

  1. 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.
  2. 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 seznam
await checkA11y(page, "stranka-x", { include: "main" });
  • 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 a11y a grep -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.

Sister bugs / související

Sekce “Sister bugs / související”
Přidal aiarchitekt.cz · 17. 11. 2026 1:00
Provozuje aiarchitekt.cz