Ovládání viditelné jen po najetí myší není dosažitelné klávesnicí ani dotykem
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Dlaždice obrázku v administraci měla dole pruh s tlačítky (posunout, vypnout, odebrat). Myší fungoval. Klávesnicí se uživatel tabulátorem dostal na tlačítko, které nebylo vidět – focus „zmizel“. Na telefonu nebylo jak pruh vyvolat. Kontrola axe byla zelená: tlačítka měla název a průhledný prvek kontrola kontrastu neposuzuje.
Root cause
Sekce “Root cause”<div className="… opacity-0 transition-opacity group-hover:opacity-100"> <button title="Vypnout">…</button></div>opacity: 0 prvek nevyřazuje z pořadí tabulátoru ani ze stromu přístupnosti. Viditelnost byla navázaná jen na :hover, který klávesnice ani dotyk nevyvolají. Stejný vzor byl zkopírovaný do další obrazovky. Příbuzná vada: řádek tabulky s onClick na <tr> jde otevřít jen myší.
Fix
Sekce “Fix”- Pruh je vidět vždy (tmavý poloprůhledný podklad pod bílými ikonami kvůli kontrastu).
- Tlačítka mají
type="button", název s pořadím položky a zřetelný rámeček při:focus-visible. - Klikatelný řádek dostal skutečné tlačítko v buňce s názvem.
Regresní test používá skutečnou klávesnici:
await firstButton.focus();await page.keyboard.press("Tab");await expect(toggle).toBeFocused();// žádný předek pod focusem nesmí být průhledný a prvek musí mít viditelný rámečekconst seen = await toggle.evaluate((el) => { const faded = []; for (let n = el; n && n !== document.body; n = n.parentElement) if (Number(getComputedStyle(n).opacity) < 1) faded.push(n.tagName); const cs = getComputedStyle(el); return { faded, outline: cs.outlineStyle !== "none" && parseFloat(cs.outlineWidth) >= 2 };});Myš se před tím přesune mimo dlaždice, aby nic nezáviselo na najetí.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection:
grep -rn "opacity-0" src | grep "group-hover"agrep -rn "<tr[^>]*onClick" src. U každého výskytu: je uvnitř ovládací prvek? - Anti-pattern:
opacity-0 group-hover:opacity-100nad tlačítky;onClickna neinteraktivním prvku; spoléhání na automatickou kontrolu přístupnosti u ovládání klávesnicí. - Lepší přístup: ovládání trvale viditelné, nebo aspoň
group-focus-within:opacity-100a@media (hover: none); test se skutečnýmTaba kontrolou průhlednosti předků.