Průhlednost celé karty u „neaktivního“ stavu srazí kontrast textu pod požadovanou mez
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Karta zrušené události na úvodní stránce měla malé texty (typ události, rok, štítek „zrušeno“) s kontrastem zhruba 3,98 : 1 místo požadovaných 4,5 : 1. Automatická kontrola přístupnosti byla dlouhodobě zelená – selhala až ve chvíli, kdy se v testovací databázi objevila zveřejněná zrušená událost. Stejný vzor byl v řádku seznamu a ve štítku měsíčního kalendáře; tam navíc zrušení nebylo vyjádřeno slovy, jen přeškrtnutím.
Root cause
Sekce “Root cause”Průhlednost se dědí vizuálně na celý podstrom: opacity na obalu smíchá barvu každého textu s pozadím. Barvy, které samy o sobě kontrastem procházejí, tak pod 60% průhledností neprojdou.
// špatně – ztlumí i všechny texty uvnitř<article className={cn("card", cancelled && "opacity-60")}>…</article>Druhá půlka chyby je v testech: kontrola přístupnosti procházela pevný seznam stránek nad běžnými daty, ve kterých žádná zrušená položka nebyla. Přípustný stav dat tedy nebyl pokrytý vůbec.
Fix
Sekce “Fix”Odlišení stavu bez průhlednosti textu: tmavší podklad karty, přeškrtnutý název v tlumenější, ale stále kontrastní barvě, slovní štítek; průhlednost a odbarvení jen u fotografie (nemá text). Ve štítku kalendáře čárkovaný rámeček, přeškrtnutí a text pro čtečky obrazovky.
const cancelledBox = "bg-ink-900";const cancelledTitle = "text-ivory-200 line-through decoration-ivory-400";
<article className={cn("card", cancelled && cancelledBox)}> <h3 className={cn("title", cancelled && cancelledTitle)}>…</h3> {cancelled && <p className="label text-danger">{t("cancelled")}</p>} <img className={cn("photo", cancelled && "opacity-50 grayscale")} alt="" /></article>Regresní test si zveřejněnou zrušenou položku (nadcházející i proběhlou) sám založí a po sobě uklidí, projde všechny stránky, kde se zobrazuje, na počítači i mobilu a ověří tři věci: kontrola kontrastu bez nálezu, u položky je slovní označení stavu, žádný prvek s textem (ani jeho předek) nemá průhlednost menší než 1.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -rn "opacity-[0-9]" src | grep -v "hover:\|disabled:\|transition"a u každého výskytu se zeptat, zda je uvnitř text. V testu lze projít předky prvku a hlídatgetComputedStyle(el).opacity < 1. - Anti-pattern: podmíněná třída
stav && "opacity-50"na řádku tabulky, kartě nebo odkazu; stav vyjádřený jen barvou nebo přeškrtnutím. - Lepší přístup: tlumená, ale ověřená barva textu, změna podkladu nebo rámečku, slovní štítek. Pro každý přípustný stav dat mít fixturu v kontrole přístupnosti – zelený test nad daty bez toho stavu nic nedokazuje.
Sister bugs / související
Sekce “Sister bugs / související”- Stejný vzor bývá v administraci u neaktivních řádků a skrytých položek menu; světlý motiv na něj trpí ještě víc (šedý text na bílé).
- Příbuzná past: zelená sada, která stav vůbec neobsahuje – viz záznamy o testech nad neúplnými daty.