Dialog 打开时触发按钮卡在 aria-hidden 祖先里¶
症状¶
Tony 日志截图:
Blocked aria-hidden on an element because its descendant retained focus.
Element with focus: <button …MuiButton-colorWarning MuiButton-sizeSmall…>
Ancestor with aria-hidden: <div#root>
根因¶
#root 被加 aria-hidden = 有 Dialog 打开了 ——
MUI 的 Modal 打开时会把背景内容对读屏隐藏。
而此时焦点还留在触发它的那个按钮上(那个按钮在背景里)。
错误信息里的 colorWarning + sizeSmall + text 组合,正是
cloud-sync-panel.tsx 的「清空」按钮。
⚠️ 与 0166-helptip-toggled-switch-and-five-gate-holes 里那个 aria-hidden 不是一回事: 那次是「同一个 svg 既可聚焦又自带 aria-hidden」,这次是 「焦点元素的祖先被加了 aria-hidden」。同一条规范,两种触发路径。
修在 ConfirmDialog 内部,不逐个按钮打补丁¶
这是所有用 ConfirmDialog 的地方共有的(清空 ×3 / 删除数据 / 重置设置…)。
逐个给按钮加 blur() 就是「同一个事实散在多处,改一处漏一处」——
本轮反复栽的那个病。
useLayoutEffect(() => {
if (!open) return;
const el = document.activeElement;
if (el instanceof HTMLElement && el !== document.body) el.blur();
}, [open]);
🔴 必须是 useLayoutEffect:它在 DOM 变更后、浏览器绘制前同步跑,
是能抢在 aria-hidden 生效前把焦点挪走的最早时机。
换成 useEffect 晚一拍,竞态仍然可能触发。
🔴 两个守卫都不能省:if (!open) return(关闭时不抢焦点)、
el !== document.body(对 body 调 blur 无意义且可能扰乱焦点链)。
断言¶
tests/confirm-dialog-focus.test.ts 三条,变异 M41(删 blur)/
M42(改用 useEffect)/ M43(去掉 open 守卫)三发全中。
v0.13.3 复发 —— 修法只覆盖了「走 ConfirmDialog 的那些」¶
Tony 截图(chrome://extensions 的错误页):
Blocked aria-hidden on an element because its descendant retained focus.
Element with focus: <button.MuiButtonBase-root …>
Ancestor with aria-hidden: <div#root>
上下文:main.html
同一个报错,原样复发。
为什么¶
当初的修法写在 ConfirmDialog 内部,注释还特意写了「修在 ConfirmDialog 内部,不逐个按钮打补丁」——
方向是对的,但覆盖面选错了一层:
- 真正的单一事实是「任何 Dialog 打开时,焦点不能留在背景里」
- 而实现绑在了「ConfirmDialog 打开时」
v0.13.x 新写的 AiAccountDialog / AiCategoryDialog 是自己写的 MUI <Dialog>,不走 ConfirmDialog ⇒ 缺守卫。
修法:抽成 src/hooks/use-dialog-focus-guard.ts¶
配 tests/dialog-focus-guard-coverage.test.ts:凡是自己 import 并渲染 <Dialog> 的组件,
都必须调 useDialogFocusGuard(open)。
🔴 这条闸立起来的当场,抓出 8 个既有 Dialog 也缺守卫:
partner-download-dialog / field-setting-dialog / tags-dialog / cdkey-dialog
pay-dialog / ticket-dialog / upgrade-level-dialog / customer-service-dialog
也就是说这个问题一直是全仓性的,只是没人点开那几个对话框看控制台。 旧判据只量 ConfirmDialog 一个文件,看不见这个范围。
判据搬家保持严格超集¶
| 旧 | 新 | |
|---|---|---|
| ConfirmDialog 里有这段逻辑 | ✅ | ✅(改为「用了共享实现」+「实现本身合格」) |
| 必须 useLayoutEffect / 排除 body / open 守卫 | ✅ | ✅(搬到守 hook) |
| 不许自己抄第二份 | ❌ | ✅ 新增 |
| 全仓每个 Dialog 都要有 | ❌ | ✅ 新增(这是旧判据看不见的那一层) |
教训¶
「不逐个打补丁」的方向对,但要选对「一个」是哪一个。 选成组件,就只覆盖用那个组件的地方;选成「行为」,才覆盖所有产生该行为的地方。