必须用 做汉堡菜单开关,因其原生支持可访问性;需设 type="button" 防表单提交,配合 aria-expanded 与 aria-controls 严格配对,并为 SVG 图标添加 aria-hidden="true"。

HTML里用<button></button>还是<div>做汉堡菜单开关
<p>必须用 <code><button></button>,不能用 <div> 或 <code><span></span> 模拟点击。屏幕阅读器、键盘焦点、原生表单提交逻辑都依赖语义化按钮元素。
- 用
<div role="button" tabindex="0"> 是补救方案,不是替代方案——它绕过浏览器对 <code><button></button> 的默认可访问性支持,容易漏掉 Enter/Space 键响应
- 如果菜单开关嵌在表单里,
<button type="button"></button> 是必须写的,否则点击会触发表单提交
- 不要给
<button></button> 加 href 属性——那是超链接的逻辑,和开关行为无关,还会导致 tab 键跳转异常
aria-expanded 和 aria-controls 怎么配对才有效
这两个属性必须同时存在且值严格对应,否则屏幕阅读器无法建立“开关”和“菜单”的关联关系。
-
aria-expanded 放在开关按钮上,值为 "true" 或 "false"(字符串,不是布尔字面量)
-
aria-controls 也放在开关按钮上,值是目标菜单容器的 id,比如 aria-controls="nav-menu"
- 被控制的菜单容器必须有对应
id="nav-menu",且不能是 display: none —— 推荐用 visibility: hidden + height: 0 + overflow: hidden 配合动画,否则部分读屏器会跳过隐藏内容
SVG汉堡图标要不要加 role="img" 和 aria-hidden="true"
要加,而且必须加。图标纯属装饰,不传递额外信息;不加会导致读屏器重复朗读路径或“svg”字样,干扰主逻辑。
- 整个 SVG 包在
<button></button> 内时,SVG 标签本身加 aria-hidden="true"
- 如果 SVG 有
<title></title> 或 <desc></desc>,必须一并移除或设 aria-hidden="true",否则仍会被读出
- 不需要加
role="img":按钮已有 role="button",SVG 只是其内部视觉元素,加了反而可能让某些读屏器误判为独立可交互对象
JavaScript 控制菜单显隐时,哪些 DOM 操作会破坏可访问性
直接改 style.display 或删/加 class 名本身没问题,但漏掉 ARIA 状态同步就是典型失能点。
DeepBI DHTML 页面生成器
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur
下载
立即学习“前端免费学习笔记(深入)”;
- 每次切换菜单,必须同步更新按钮上的
aria-expanded 值,不能只靠 CSS 类判断状态
- 不要用
classList.toggle("open") 后就结束——得手动写 button.setAttribute("aria-expanded", "true")
- 避免用
innerHTML 替换整个按钮内容,会重置焦点和读屏器缓存状态;更新图标应只操作 <path></path> 的 d 属性或 class
- 动画完成后再更新 ARIA 状态更稳妥,但多数场景下「状态先行」即可,重点是别忘了这步
最常被忽略的是:菜单容器没设 role="navigation",或者开关按钮没写 aria-label="打开导航菜单" —— 当图标无文字时,这个 label 就是读屏器唯一能告诉用户“这是干啥”的地方。
<div role="button" tabindex="0"> 是补救方案,不是替代方案——它绕过浏览器对 <code><button></button> 的默认可访问性支持,容易漏掉 Enter/Space 键响应
<button type="button"></button> 是必须写的,否则点击会触发表单提交<button></button> 加 href 属性——那是超链接的逻辑,和开关行为无关,还会导致 tab 键跳转异常aria-expanded 和 aria-controls 怎么配对才有效
这两个属性必须同时存在且值严格对应,否则屏幕阅读器无法建立“开关”和“菜单”的关联关系。
-
aria-expanded放在开关按钮上,值为"true"或"false"(字符串,不是布尔字面量) -
aria-controls也放在开关按钮上,值是目标菜单容器的id,比如aria-controls="nav-menu" - 被控制的菜单容器必须有对应
id="nav-menu",且不能是display: none—— 推荐用visibility: hidden+height: 0+overflow: hidden配合动画,否则部分读屏器会跳过隐藏内容
SVG汉堡图标要不要加 role="img" 和 aria-hidden="true"
要加,而且必须加。图标纯属装饰,不传递额外信息;不加会导致读屏器重复朗读路径或“svg”字样,干扰主逻辑。
- 整个 SVG 包在
<button></button>内时,SVG 标签本身加aria-hidden="true" - 如果 SVG 有
<title></title>或<desc></desc>,必须一并移除或设aria-hidden="true",否则仍会被读出 - 不需要加
role="img":按钮已有role="button",SVG 只是其内部视觉元素,加了反而可能让某些读屏器误判为独立可交互对象
JavaScript 控制菜单显隐时,哪些 DOM 操作会破坏可访问性
直接改 style.display 或删/加 class 名本身没问题,但漏掉 ARIA 状态同步就是典型失能点。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记(深入)”;
- 每次切换菜单,必须同步更新按钮上的
aria-expanded值,不能只靠 CSS 类判断状态 - 不要用
classList.toggle("open")后就结束——得手动写button.setAttribute("aria-expanded", "true") - 避免用
innerHTML替换整个按钮内容,会重置焦点和读屏器缓存状态;更新图标应只操作<path></path>的d属性或 class - 动画完成后再更新 ARIA 状态更稳妥,但多数场景下「状态先行」即可,重点是别忘了这步
最常被忽略的是:菜单容器没设 role="navigation",或者开关按钮没写 aria-label="打开导航菜单" —— 当图标无文字时,这个 label 就是读屏器唯一能告诉用户“这是干啥”的地方。


















