和是语义正确、无需JS、自带无障碍支持的原生折叠方案,但不支持自动滚动、手风琴互斥或height过渡动画,需JS补充。

details 和 summary 是最直接、最稳妥的方案,不用写 JS,语义正确,键盘和屏幕阅读器都认得。但别指望它能自动滚动、手风琴互斥或高度过渡动画——这些得自己加逻辑。
为什么优先用 details 而不是手写 display: none
原生标签自带可访问性保障:空格/回车可触发、aria-expanded 自动同步、焦点不丢失。手写 JS 控制 style.display 容易漏掉 tabindex、aria-hidden 或焦点恢复,尤其在帮助文档这种用户可能键盘导航的场景里,一不留神就卡住。
-
summary必须是details的第一个子元素,否则点击无效 - 默认收起;加
open属性即默认展开:安装步骤
... - IE 完全不支持,需降级检测:
if (!('open' in document.createElement('details'))) { /* 加载 JS 方案 */ }
Safari 里 summary::marker 不生效怎么办
Safari 对 ::marker 渲染支持差,别只靠它改箭头。统一用 summary::before + transform 替代:
summary {
list-style: none;
padding-left: 24px;
position: relative;
}
summary::before {
content: "▶";
position: absolute;
left: 0;
top: 50%;
transform: translateY(-50);
transition: transform 0.2s;
}
details[open] summary::before {
content: "▼";
transform: translateY(-50) rotate(90deg);
}
- 不要设
height或transition在details上——它的高度是动态计算的,强行过渡会抖动或失效 - 若内容含图片或 iframe,
details展开后不会自动触发 lazy-load,需监听toggle事件手动处理
要实现手风琴效果(点一个、其他关掉)
原生 details 默认各自独立,互斥必须用 JS。监听 toggle 事件比监听 click 更可靠,因为后者不响应键盘操作:
document.querySelectorAll('details').forEach(d => {
d.addEventListener('toggle', () => {
if (d.open) {
document.querySelectorAll('details:not(:is(#' + d.id + '))').forEach(el => el.removeAttribute('open'));
}
});
});
- ID 不是必须的,但加了 ID 可避免重复遍历全部节点,性能更可控
- 别用
display: block/none模拟——这会让details失去语义和可访问性,退化成普通 div - 如果内容高度差异大(比如从 1 行文字到 5 张图),纯 CSS 的
max-height固定值会导致“弹跳”,此时必须用 JS 动态读取scrollHeight
真正难的不是写出能折叠的代码,而是判断哪些交互细节用户真会在意:是否要键盘操作?是否要语音朗读?是否要展开后自动滚到顶部?这些问题没想清,先堆动画反而容易翻车。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











