原生 details + summary 实现折叠展开,无需 JS、语义正确、可访问性强、SEO 友好;需避免 CSS 干扰、错误嵌套及兼容性盲区,推荐特性检测降级。

用 details + summary 最快实现折叠展开
原生 HTML 就支持,不用 JS、不引库,兼容 Chrome 12+、Firefox 49+、Safari 6+、Edge 79+。适合「商品参数」「包装清单」「售后说明」这类静态内容区块。
常见错误是直接套用 div 加 class 模拟,结果语义缺失、屏幕阅读器无法识别、SEO 友好度下降。
正确写法:
<details><summary>? 包装清单</summary><p>主机 × 1</p> <p>Type-C 充电线 × 1</p> <p>说明书 × 1</p> </details>
要点:
-
details默认收起,加open属性可默认展开: -
summary内容会自动加箭头(部分浏览器可自定义,但别覆盖掉交互反馈) - 不要在
summary里放button或a,会干扰默认展开逻辑 - 里面可以嵌套任意 HTML,包括图片、表格、甚至另一个
details
需要动态控制(比如点击按钮展开所有)就得用 JS
原生 details 不提供 JS API 控制展开状态,只能靠 open 属性 + setAttribute 操作。
典型场景:页面顶部放个「全部展开」按钮,一键展开所有参数项。
实操建议:
- 给每个
details加统一 class,比如js-accordion - 用
element.open = true(或false)比setAttribute('open', '')更可靠 - 注意 Safari 旧版本对
open属性变更的响应有延迟,加个offsetHeight强制重排可缓解 - 别监听
click到summary上再手动 toggle——破坏了原生行为,反而增加维护成本
移动端点透、滚动卡顿?检查 CSS 覆盖是否过度
很多团队用 details 后发现 iOS 点击没反应,或展开后页面卡住,大概率是 CSS 干扰了原生行为。
容易踩的坑:
- 给
details设overflow: hidden+height: 0动画——这完全绕过了原生机制,等于自己重写一套,失去语义和可访问性 - 给
summary加pointer-events: none,导致点击失效 - 用
transform: scale(0.99)做“防抖”,意外禁用了 iOS 的点击区域检测 - 展开内容含大量图片或 iframe,没做懒加载,首次展开时主线程阻塞
推荐做法:只用 CSS 控制外观(字体、颜色、边框),保留 details 的自然流式布局和高度计算。
想兼容 IE 或老 Android?得降级为 JS 方案
details 在 IE 完全不支持,Android 4.4 WebView 也不支持。如果目标用户仍有这部分设备,不能硬上。
降级策略要务实:
- 优先检测
'open' in document.createElement('details'),而不是 UA 字符串 - 降级后用
max-height+transition实现动画,别用height: auto——CSS 不支持该值过渡 - 给降级组件加
role="region"和aria-expanded,保证基础可访问性 - 避免同时加载两套逻辑(原生 + JS),用特性检测分流,减少 bundle 体积
折叠展开本身不难,难的是在语义、性能、兼容、可访问之间不妥协。最容易被忽略的,其实是展开后焦点管理——用户按 Tab 键时,光标该落在哪?这个细节决定了真实体验的下限。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











