和是唯一无需JS、语义正确且键盘可访问的原生折叠方案,浏览器内置状态管理、焦点逻辑与屏幕阅读器支持;必须为首个子元素,加open属性可默认展开;Safari对::marker支持不稳定,推荐用list-style: none配合::before定制图标。

和 是唯一无需脚本、语义正确、键盘可访问的原生方案。其他所谓“纯 CSS”方案(如 :checked + )依赖伪交互,无法被屏幕阅读器识别状态变化,也不支持空格/回车切换,不属于无障碍合规方案。
为什么是真正无脚本且合规的选择
它不是“模拟”,而是 HTML5 原生定义的折叠语义元素:浏览器内置状态管理、焦点逻辑、键盘支持(Space 和 Enter 均可触发)、屏幕阅读器自动播报“已展开”/“已折叠”。不需要监听 click、不需操作 display 或 max-height,更不用手动维护 ARIA 属性。
-
必须是的第一个子元素,否则点击无效 - 默认收起;加
open属性即默认展开:标题
内容 - 内容区域自动参与文档流,无需设
height: 0或overflow: hidden - IE 完全不支持,但 Chrome 12+、Firefox 49+、Safari 6+、Edge 79+ 全覆盖(截至 2026 年)
样式定制必须绕开::marker的原因
Safari 对 summary::marker 的支持长期不稳定——即使在 Safari 17 中,content: "" 仍可能失效,或展开后图标残留。强行依赖会导致视觉反馈丢失,用户无法判断当前状态。
- 正确做法:先用
summary { list-style: none; }清除默认箭头 - 再用
summary::before插入可控图标,例如content: "▶"; margin-inline-start: 8px; - 旋转动画靠
details[open] summary::before { transform: rotate(90deg); transition: transform 0.2s; } - 避免用
vertical-align对齐图标——改用display: flex; align-items: center;更可靠
哪些“看似无脚本”的需求其实必须用 JS
原生 不提供批量控制能力,这是规范限制,不是兼容性问题。
- “全部展开/收起”按钮:CSS
:has()无法设置open属性,open也不是可继承的 CSS 属性,必须用 JS,哪怕只有一行:document.querySelectorAll('details').forEach(d => d.open = true) - URL 参数驱动初始状态(如
#faq-3自动展开第三项):需 JS 读取location.hash后设置对应的open属性 - 折叠内容内含
或,且希望收起时完全跳过 Tab 键盘导航:原生行为下这些元素仍在 DOM 中、仍可聚焦,必须用 JS 移除/重挂载或动态设tabindex="-1"
最常被忽略的是:折叠内容里的链接和表单控件,在收起状态下依然能被键盘 Tab 访问到——这不是 bug,是规范要求的可访问性保障。如果业务逻辑真需要“移除交互”,那就已经超出原生能力边界,JS 不是可选项,而是必要项。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











