details 和 summary 是 HTML5 原生折叠组件,语义清晰、无障碍及 SEO 友好;仅允许一个 summary,其余为可折叠内容;支持 open 属性默认展开;现代浏览器兼容,IE 不支持。

用 details 和 summary 实现原生折叠展开
HTML5 原生支持折叠展开,不用 JS 就能跑,语义清晰、无障碍友好、SEO 友好。关键就两个标签:details 包裹整个区块,summary 作为触发标题。
常见错误是把 summary 写成多个,或者在 details 外再套一层 div 导致样式错位。它只允许一个 summary,其余内容自动成为“可折叠体”。
示例:
<details> <summary>点击展开配置项</summary> <p>host: localhost</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记(深入)</a>”;</p> <p>port: 3000</p> </details>
注意:默认展开需加 open 属性,如 <details open></details>;Chrome/Firefox/Safari 都支持,IE 不支持——如果必须兼容 IE,得换方案。
用 CSS 控制 details 的外观和动画
原生 details 默认没有展开收起动画,直接跳变。想加淡入/高度过渡,得绕点路:不能直接对 details 或 summary 设 transition,因为内部内容是 display: none/block 切换,不触发 CSS 动画。
可行做法是用 max-height + overflow: hidden 模拟,配合 :has()(仅现代浏览器)或 JS 切 class。更稳妥的是用 JS 监听 toggle 事件,手动加类:
- 监听
details的toggle事件 - 展开时加
is-open类,收起时移除 - CSS 中写
.is-open + * { max-height: 500px; opacity: 1; }等过渡规则
别忘了重置 summary 的默认箭头:用 summary::marker { content: "▸ "; } 自定义符号,或 list-style: none 彻底去掉。
用 JS 手动控制折叠状态的边界情况
当需要批量操作(比如“全部展开”按钮)、或与表单联动(如折叠项里有 input,收起时要校验),就得用 JS 主动干预。核心方法只有两个:element.open = true/false 和 element.hasAttribute('open')。
容易踩的坑:
-
open是 DOM 属性(property),不是 HTML 属性(attribute)——设el.setAttribute('open', '')不生效,得用el.open = true - 多个
details共享同一份 JS 逻辑时,别用querySelector写死单个元素,改用querySelectorAll('details')遍历 - 在 Vue/React 中直接操作
open属性可能被框架 patch 覆盖,建议用ref或useRef拿到真实 DOM 后再改
另外,toggle 事件不会冒泡,也不能取消,所以无法用事件委托——每个 details 得单独绑定。
兼容 IE 或需要复杂交互时该选什么替代方案
如果项目仍需支持 IE11,details 就得放弃。此时最轻量的替代是手写一个带 aria-expanded 和 aria-controls 的 button + div 组合,并用 JS 控制 hidden 属性或 max-height 过渡。
关键点:
- 必须同步更新
aria-expanded="true/false"和关联区域的id - 键盘操作要支持
Enter和Space触发,且焦点管理要合理(展开后焦点是否进内容区?) - 避免用
display: none隐藏内容,否则屏幕阅读器会跳过——改用visibility: hidden; height: 0; overflow: hidden;更安全
第三方库如 collapse.js 或 Bootstrap 的 Collapse 插件虽省事,但会引入额外体积和样式耦合,简单页面没必要。
真正难的不是实现折叠,而是让键盘用户、屏幕阅读器用户和鼠标用户获得一致体验——所有状态、焦点、语义标记都得对齐,这点常被忽略。



















