Dialog vyšší než obrazovka bez vnitřního rolování – zavření je na mobilu mimo dosah
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Výběr souboru z naplněné knihovny otevřený na telefonu ukázal jen prostředek mřížky. Hlavička, hledání a zavírací křížek byly nad horním okrajem obrazovky a stránka pod dialogem se nerolovala. Na klávesnici pomohl Escape, dotykem dialog zavřít nešlo. Testy byly zelené: hlídaly jen vodorovné přetékání a automatickou kontrolu přístupnosti.
Root cause
Sekce “Root cause”Společná komponenta dialogu je pevně vycentrovaná a nemá omezení výšky:
className="fixed left-[50%] top-[50%] translate-x-[-50%] translate-y-[-50%] grid w-full max-w-lg …"Je-li obsah vyšší než obrazovka, střed zůstane uprostřed a horní okraj vyjde do záporných souřadnic. Bez overflow-y není čím se k němu dostat. Krátké dialogy (potvrzení) to neodhalí – projeví se až obsah závislý na datech.
Fix
Sekce “Fix”className="fixed left-[50%] top-[50%] … max-h-[calc(100dvh-1rem)] overflow-y-auto overscroll-contain"dvh počítá s lištami mobilního prohlížeče; overscroll-contain brání rolování stránky pod dialogem.
Test na několika mobilních rozměrech včetně malé výšky, s dotykovým kontextem a se skutečně naplněným obsahem:
const m = await dialog.evaluate((el) => { const r = el.getBoundingClientRect(); return { top: r.top, bottom: r.bottom, vh: innerHeight, scrolls: el.scrollHeight > el.clientHeight };});expect(m.top).toBeGreaterThanOrEqual(0);expect(m.bottom).toBeLessThanOrEqual(m.vh);// zavírací tlačítko na obrazovce, vnitřní rolování skutečně posune obsah, zavření ťuknutímZměna společné komponenty se ověřuje na více dialozích najednou (dlouhý, střední, krátký), aby oprava jednoho nerozbila jiný.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: najdi společnou komponentu dialogu a hledej
max-h/overflow-y. Otevři na 360×640 dialog s nejdelším reálným obsahem. - Anti-pattern: vycentrovaný
fixedprvek bez omezení výšky; test dialogu jen s krátkým obsahem; kontrola pouze vodorovného přetékání. - Lepší přístup: omezená výška, vnitřní rolování, hlavička a zavření vždy dosažitelné; měřit polohu, ne jen existenci prvků.