跳转至

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 都要有 ❌ ✅ 新增(这是旧判据看不见的那一层)

教训

「不逐个打补丁」的方向对,但要选对「一个」是哪一个。 选成组件,就只覆盖用那个组件的地方;选成「行为」,才覆盖所有产生该行为的地方。