HTML <details> 标签可实现基础折叠/展开,但IE全系不支持,Edge 12–18无动画且toggle事件不可靠,旧版Safari(≤15.4)嵌套渲染异常;手动绑定onclick会破坏可访问性、键盘支持和事件监听,正确做法是监听toggle事件;max-height过渡需动态读取scrollHeight避免跳变;手风琴效果须JS管理open状态并防抖处理。
HTML 原生 <details> 标签能实现基础折叠/展开,但“兼容展开收起”要看你指的兼容性维度——浏览器支持、可访问性、动画效果、状态联动,这四者无法同时满足。
IE 所有版本完全不支持 <details>;Edge 12–18 虽能切换状态,但无动画、toggle 事件不可靠;旧版 Safari(≤15.4)对嵌套 <details> 渲染异常,且 ::marker 伪元素不生效。若项目需兼容 IE 或企业内网旧环境,必须降级为 JS + max-height 方案,或引入 details-polyfill。
手动绑定 onclick 并操作 display 或 hidden 属性,会直接破坏以下三点:
aria-expanded 不会自动更新toggle 事件监听失效,后续逻辑无法响应真实展开动作正确做法是只监听 toggle 事件:
details.addEventListener('toggle', (e) => { console.log(e.target.open); }); 它在 Safari、Chrome、Firefox 中稳定触发,且涵盖鼠标和键盘行为。立即学习“前端免费学习笔记(深入)”;
常见错误是把 max-height 设为 0 → auto,CSS 不支持 auto 过渡,结果就是跳变。真正可控的做法是:
content.scrollHeight,设为 max-height 值(如 240px)max-height: 0 并同步加 overflow: hidden
transitionend 后重新测量,否则下次展开可能撑不开或截断9999px),会导致滚动条异常或影响 getBoundingClientRect() 计算<details> 之间完全独立,没有内置状态协调机制。要实现点击一个展开、其他收起,必须用 JS 管理状态:
open 属性双向绑定——它只是单向反射 DOM 状态,不是响应式数据data-active-id 在父容器上集中记录当前展开项 ID<details>,手动设 open = false,再设目标为 true
open = false 会触发一次 toggle 事件,需加防抖或标记跳过最易被忽略的是:当用户用键盘操作(Tab 到 summary 后按空格),JS 必须确保焦点不丢失、状态同步、且不打断原生语义流——这点纯 CSS 方案几乎无法做到。