Přeskočit na obsah

Průhlednost celé karty u „neaktivního“ stavu srazí kontrast textu pod požadovanou mez

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

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.

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.

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ídat getComputedStyle(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.
Přidal aiarchitekt.cz · 17. 11. 2026 1:00
Provozuje aiarchitekt.cz