跳转至

[ISSUE-0173] aria-hidden 焦点报错三度复发

Chrome 报:Blocked aria-hidden on an element because its descendant retained focus. Element with focus: <div.MuiSelect-select … Mui-error …> Ancestor with aria-hidden: <div#root>

三次修法,三次都只补住当时那个口子

版本 修法 绑在什么上 漏了什么
ISSUE-0169 ConfirmDialog 里 blur 组件 新写的 Dialog 不走它 ⇒ 原样复发
v0.13.3 抽 useDialogFocusGuard(open) 打开这一刻 Dialog 关闭时 MUI 把焦点还给 trigger,而 aria-hidden 还没清干净
v0.13.8 怀疑 Tooltip 包 Select,加一层 span 一个猜测的成因 🔴 实测复现不出,这个修法从未被证明有效

v0.14.2:不认路径,只认状态

「焦点」+「aria-hidden 祖先」同时出现就是错的,不管它是怎么来的。 ⇒ 全局 focusin(capture)守卫,发现就 blur + 留痕。

和 ext-context-guard 那条「绑在行为上而不是调用点上」是同一个道理。

验证到哪一步 —— 以及没到哪一步

✅ 判定逻辑:isInAriaHidden() 抽成纯函数,用假 DOM 逐条验 (祖先 hidden / 自己 hidden / aria-hidden="false" 不算 / 非元素不抛错)。

✅ 接线:覆盖闸扫 src/entrypoints/*/main.tsx,每个 entry 都必须 import。 —— 这条是实测撞出来的:守卫原本放在 use-dialog-focus-guard.ts 里靠「有人 import」自启, 结果哪个页面没有 Dialog,哪个页面就没有守卫。

v0.14.3 后记:真机坐实了守卫在工作

Tony 截图里那条 [focus-guard] 焦点落进了 aria-hidden 子树,已移走:… 是本守卫自己的留痕,不是 Chrome 的 Blocked aria-hidden。

⇒ 两个结论: 1. ✅ 守卫在真机确实触发并拦住了 —— 也反过来坐实:真实环境里的确有代码 把焦点放进 aria-hidden 子树(隔离预览页测不出来,是因为那个窗口本身没有焦点) 2. 🔴 但留痕用了 console.warn,而 chrome://extensions 的错误面板会收集 warn/error ⇒ 用户看到的还是「插件在报错」。已降级为 console.debug。

一个只在正常工作时才出现的条目,不该长得像故障。


🔴 真实焦点行为:验不了,没有假装验过。 它依赖浏览器窗口自身有焦点 —— 在无头/后台窗口里 .focus() 连 focusin 都不触发 (v0.14.2 实测:不加 aria-hidden 时同样 0 次触发)。 ⇒ 这一层只能在真机上确认:chrome://extensions → 该扩展 → 「错误」。

🔴 连带教训:v0.13.8 那次「对照组和修复组表现一样」的结论也不可靠 —— 不是两者真的一样,是那个环境根本测不了焦点。 用一个测不了目标行为的环境做对照,得到的「无差别」是没有信息量的。

相关