Accessibility面板无反应是因为未选中存在于无障碍树中的元素;必须先用吸管选取可见、未被aria-hidden排除的元素,再切换至该面板,否则Computed Role/Name/States三列为空。

为什么用浏览器开发者工具看Accessibility面板没反应
因为 Accessibility 面板默认只显示已渲染的 DOM 节点,且依赖语义化结构——如果页面全是 实操建议: 两者同时写在同一个元素上, 常见错误场景: 很多开发者以为给 正确做法必须满足至少一项: 因为 NVDA 默认启用 Form Mode(表单模式),遇到非语义容器(比如 关键排查点: 最常被忽略的一点:无障碍不是“加上 aria 就完事”,而是从 、、 这类语义标签,面板里就几乎为空,不是工具坏了,是结构“没告诉”浏览器该读什么。
是否存在且值正确;缺失或写成 lang="zh" 会导致 VoiceOver/NVDA 直接跳过整页标题层级 是否在文件第一行,前面不能有空格、BOM 或注释
必须是 的直接子元素,嵌套在 duplicate-main 错误,NVDA 也会跳过
aria-label 和 aria-labelledby 混用会出什么问题
aria-labelledby 会被完全忽略,且 axe、WAVE、Lighthouse 全部报 aria-allowed-attr 错误——这不是警告,是明确违反 ARIA 规范。
→ 实际只读 aria-label,但若 UI 后续把 id="close-btn" 对应的文本改成“收起面板”,屏幕阅读器仍固执地读“关闭”aria-label 的情况极少:纯图标按钮(无文字)、加载中 spinner、占位符按钮;其余一律用 aria-labelledby,哪怕要额外加一个 搜索
aria-labelledby 可指向多个 ID(空格分隔),但所有 ID 必须存在于 DOM 中,且不能是 display: none;visibility: hidden 或 opacity: 0 不影响可访问性读取表单元素没加 label 就算加了 aria-label 也白搭
加了 aria-label="邮箱" 就够了,但实际测试中,NVDA 在 Form Mode 下仍无法关联该输入框与它的“含义”,键盘用户 Tab 进去后听不到上下文。
显式关联(推荐) 包在 内:
aria-labelledby 指向一个可见的、非 display: none 的文本节点,而非仅靠 aria-label
、、 都需有可访问名称(accessible name),否则 JAWS 会跳过,Lighthouse 报 form-field-missing-label
为什么 NVDA 读不出 h2-h6 层级,但 Chrome 的 Accessibility 面板却显示正常
)时,会跳过内部标题;而 DevTools 的 Accessibility 面板只是静态解析 DOM 树,并不模拟真实交互流。标题
却没配 :语义化 -
要求必须有标题,否则 AT 认为它只是个普通容器 后直接跟 :这会让屏幕阅读器用户迷失层级关系,部分版本 NVDA 会静默跳过 必须全页唯一,且通常放在 内;若页面由 JS 动态注入内容,记得同步更新 document.title 和 文本,否则 VoiceOver 切页后仍读旧标题 开始,到每个 的显式 关联,再到 的位置约束——这些硬性规则不满足,任何 ARIA 补救都只是表面功夫。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











