原生 + 是唯一无需 JS 即支持语义、键盘导航与无障碍的方案;必须确保 为首个子元素、不篡改其 display/appearance、同步控制 tabindex 与 aria-hidden,并用 max-height 实现动画。

details/summary 原生就支持键盘操作,别自己造轮子
直接用 <details></details> + <summary></summary>,空格键、回车键都能触发展开/收起,屏幕阅读器会自动播报“已折叠”或“已展开”状态。这是唯一一个不用 JS 就能同时满足语义、键盘导航、无障碍的 HTML 方案。
常见错误是把 <summary></summary> 当成普通 <div>,加 <code>onclick 或手动切 display —— 这会让 Safari 失去折叠逻辑,键盘按了没反应,而且屏幕阅读器完全读不出状态变化。
-
<summary></summary>必须是<details></details>的第一个子元素,否则点击和键盘都无效 - 不要给
<summary></summary>设display: block或appearance: none,会丢掉按钮语义和焦点能力 - 想改图标?用
summary::before+transform: rotate(),别碰::marker(Safari 15.4 之前基本不认)
tabindex="-1" 和 aria-hidden="true" 必须同步控制
当折叠内容被隐藏时,光靠 CSS 的 display: none 不够。如果用户用 Tab 键导航,焦点仍可能落到不可见的 <summary></summary> 或内部控件上,造成“卡在空气里”的体验。
正确做法是:折叠时,给对应 <summary></summary> 加 tabindex="-1",并设 aria-hidden="true";展开时还原为 tabindex="0" 和 aria-hidden="false"。
立即学习“前端免费学习笔记(深入)”;
- 别用
visibility: hidden或opacity: 0替代display: none—— 它们不移除可聚焦能力 - 如果用了 JS 控制展开/收起(比如根据 URL 参数),记得同步更新这两个属性,不能只改
open - 用
details[open] > summary选择器批量处理样式时,也要注意属性同步,避免视觉与状态错位
需要动画?max-height + JS 是唯一靠谱路径
<details></details> 原生不支持 height 过渡,强行加 transition: height .3s 会失效或抖动。要滑动效果,必须放弃原生高度计算,改用 max-height 模拟。
关键不是写 JS,而是怎么测高、怎么清状态:
- 展开前读取目标内容的
scrollHeight,设为max-height行内值 - 收起时设
max-height: 0,且必须配overflow: hidden,否则可能漏出滚动条 - 动画结束后,建议清空
max-height行内样式(设为''),否则后续scrollHeight可能误读为 0 - 别写死
max-height: 500px—— 小内容会弹跳,大内容会截断
移动端热区和焦点链容易被忽略
真机测试时,手指点三遍、Tab 键走两轮,经常暴露两个问题:一是热区太小(尤其折叠图标),二是焦点跳转顺序断裂(比如从 header 直接跳到 footer,中间的 <summary></summary> 被跳过)。
一级菜单项的点击区域必须 ≥ 44×44px,这不是建议,是 iOS/Android 可访问性硬要求。焦点顺序则依赖 DOM 位置和 tabindex 值,别指望 CSS order 或 z-index 能调整它。
- 用
outline或box-shadow给:focus-visible加清晰视觉反馈,别只靠浏览器默认虚线 - 折叠后所有子级容器(如
.submenu)必须用display: none强制隐藏,不能只靠height: 0 - 如果侧边栏有全局折叠开关,它的
<label></label>必须带for属性,且指向的<input type="checkbox">id 必须完全一致(大小写、连字符都不能错)



















