details 元素原生支持折叠展开,语义化强、兼容现代浏览器,配合 summary 可直接实现;需注意 summary 必须为首子元素、默认收起、可加 open 属性初始展开,旧版微信需 JS 降级。

用 details 和 summary 最快实现,无需 JS
HTML 原生就支持折叠展开,details 元素是专为此设计的语义化方案。浏览器默认提供箭头图标和交互逻辑,兼容性已覆盖所有现代浏览器(Chrome 12+、Firefox 49+、Safari 6+、Edge 79+),连 iOS Safari 都没问题。
直接写:
<details><summary>点击展开全文</summary><p>这里是被折叠的长文本……</p> </details>
注意:summary 必须是 details 的第一个子元素;内容可放任意 HTML,不只是纯文本。
常见误区:
-
details默认是收起状态,加open属性可让它初始展开: - 不要套在
div或其他块级容器里再试图“控制显示”,会破坏语义和键盘可访问性 - 部分旧版微信内置浏览器(X5 内核)不支持,如需兼容可降级为 JS 方案(见下节)
需要自定义样式或兼容老微信?用 aria-expanded + JS 控制
当 details 不可用,或你必须换图标、加动画、绑定事件时,就得手动管理状态。核心是用 aria-expanded 告诉屏幕阅读器当前状态,并配合 CSS 切换 max-height 或 visibility。
关键实操点:
- 按钮必须带
role="button"和tabindex="0",确保键盘可聚焦 - 切换时同步更新
aria-expanded="true/false"和目标容器的hidden属性(或 class) - CSS 动画建议用
max-height过渡(设一个足够大的值如max-height: 500px),避免height: auto无法过渡 - 别用
display: none做隐藏——它会让屏幕阅读器彻底跳过内容,应优先用hidden属性或visibility: hidden+position: absolute
details 的样式限制和绕过方法
原生 details 的箭头图标不能用 CSS 直接替换(::marker 支持有限,且 Safari 不认),但可以隐藏并自定义:
- 用
summary::marker { content: "" }清空默认符号(Firefox/Chrome 有效,Safari 需额外处理) - 给
summary加position: relative,再用伪元素::before绘制自定义图标(如▼或 SVG) - 箭头朝向要随状态变化:监听
toggle事件,JS 切换 class,CSS 用.details-open summary::before { transform: rotate(180deg) } - 注意:Safari 对
details[open] summary::before的样式支持不稳定,建议统一用 JS 控制 class
移动端触摸体验容易被忽略的细节
折叠区域在手机上点不准、响应慢,往往不是代码问题,而是交互细节没到位:
-
summary元素默认 padding 很小,iOS 上点击热区不足,务必加padding: 12px或更大 - 避免在
summary里嵌套button或a标签——会导致双击、事件冒泡异常 - 长文本内若有链接或表单控件,折叠后仍需保持可访问:用
hidden而非display: none,否则 VoiceOver 会跳过 - 如果全文含大量图片或 iframe,折叠时它们仍在加载,可加
loading="lazy"或在details关闭时用 JS 暂停 iframe 的src
最简健壮方案仍是 details + 少量 CSS 修饰;只有当你明确需要动画、老环境兼容或深度定制时,才值得引入 JS 控制逻辑。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











