2026 年遠端 Mac 前端發布驗收:
<dialog> 與模態焦點陷阱在 Safari/Chromium 的差異對照表及漸進增強三步清單
以可簽核的發布驗收為目標:<dialog>/showModal() 統包頂層、::backdrop 與模態焦點,但 WebKit 與 Blink 在 Tab、旁白與關閉後復歸常有表觀差;疊 polyfill 或第二套焦點陷阱易雙重攔截。本文含差異表、三步驗收、手動用例、polyfill/降級與 FAQ。延伸:Popover 驗收、Playwright 與真機;日文 同 slug。
發布驗收典型痛點
1) Tab 在 Chromium 看似被關住,Safari 卻可能漏焦到背後或關閉後落在消失節點。
2) 混用 show()/showModal() 使頂層、背面鎖與 ::backdrop 期待漂移。
3) 第三方焦點陷阱與原生 dialog 重疊,旁白順序錯亂或雙重循環。
凍結同一預發布網址與劇本,雙引擎各留證;工單寫清外側點擊是否關閉、初始焦點控件。
可引用: 組建、SHA、外側點擊政策。
Safari 與 Chromium 差異對照表
觀點隨小版變動,以凍結版號為準;建置識別可併 SW 驗收票對齊。
| 觀點 | Safari/WebKit | Chromium |
|---|---|---|
showModal()/頂層 |
外側點擊、鎖捲、動畫組合下體感差異多;宜真機多一組證據。 | 相對一致;忌與自訂 z-index 互搶,仍須同劇本對照 Safari。 |
| 焦點陷阱/Tab | 可編輯區、影子 DOM 邊界易出邊角例;旁白需短測。 | 多數正常;shadow 內可聚焦節點仍可破孔。 |
| 關閉後復歸 | 未必回觸發鈕;鍵盤易「斷線」。 | 建議顯式還原觸發元素,少賴隱式行為。 |
可引用: Esc、關閉鈕、外側(若允許)三路錄影。
漸進增強三步與五手走查
三步驗收
- 基線:無
showModal仍以覆蓋層完成同流;焦點可見可關。 - 原生契約:鎖背面、初始焦點、Tab、復歸依表與用例,改版不改默契。
- polyfill 邊界:只補 API;禁與第二套 trap 併用;異常旗標回基線。
五步走查 偵測分岔;降級 role="dialog"+aria-modal;Playwright webkit/chromium 冒煙含鍵盤;遠端 Mac 旁白+外側政策短測;靜態擋雙掛。
'showModal' in HTMLDialogElement.prototype
可引用: README 固定三詞:基線、原生契約、polyfill 邊界。
可測試用例(手動重播)
每用例 Safari/Chromium 各一輪;鍵盤+指標尤佳。
- 開啟後首焦點符合規格(標題/首欄/主要動作)。
- Tab 周回不進背面可聚焦主文;
Esc、關閉鈕、外側(若允許)關閉且不雙觸close。 - 關閉復歸觸發鈕或票載替代點;長文捲動不誤捲背面。
polyfill 與回退策略要點
polyfill:只補 dialog API;禁重複全域鍵盤監聽;條款與體積寫工單。
回退:role="dialog"、可見關閉、遮罩 CSS;背面用 inert 或點擊攔截擇一;外側是否關閉產品拍板。
運維:開關耗時/錯誤超閾值先關旗標回基線,勿再加攔截器。
FAQ
一定要原生 dialog?
非必;若已上應寫清鍵盤/旁白契約並用表驗收。
Popover 取代?
輕提示用 Popover;阻擋主流程仍宜 dialog。
無頭夠嗎?
回歸可;旁白宜真機短簽。