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

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



















