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

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











