标签默认折叠,无需js;仅含一个,用::marker自定义箭头;互斥需js监听toggle事件;移动端失效常因pointer-events: none。

details 标签默认就是折叠的,不需要额外 JS
浏览器原生支持 <details></details>,初始状态默认收起,点 <summary></summary> 才展开——这就是最简手风琴效果。它不依赖 JS,语义清晰,还自带可访问性(屏幕阅读器能识别展开/收起状态)。
常见误区是手动加 open 属性或写 JS 控制显隐,反而破坏原生行为。真正要做的只是:确保结构正确、样式可读、别用 display: none 强行隐藏 <summary></summary>。
-
<details></details>内部只能有一个<summary></summary>(放在最前),其余内容自动成为折叠区 - 不加
open属性 = 默认折叠;加了 = 默认展开(比如 FAQ 里想默认展开某条) - 不要给
<summary></summary>设display: none或visibility: hidden,否则点击无效
summary 前面的小箭头怎么改?用 ::marker 伪元素
Chrome / Edge / Safari 都支持 ::marker 控制 <summary></summary> 前的默认三角符号。Firefox 目前还不支持该伪元素,但可用 list-style 回退。
<pre class="brush:php;toolbar:false;">summary {
list-style: none; /* 先清空默认符号 */
}
summary::marker {
content: "▶ ";
color: #666;
}
details[open] > summary::marker {
content: "▼ ";
}注意:::marker
<summary></summary> 生效,且不能用 background 或 padding——它只接受 content、color、font 类属性。多个 details 怎么实现单开单关(互斥)?必须用 JS
原生 <details></details> 之间完全独立,没有“同一组内只允许一个展开”的机制。要手风琴互斥效果,得监听 toggle 事件并手动关闭其他项。
- 监听每个
<details></details>的toggle事件(不是click) - 在事件处理器中,遍历同组所有
<details></details>,对非当前项调用.removeAttribute('open') - 避免用
.open = false,因为会触发二次toggle事件,导致逻辑错乱
<pre class="brush:php;toolbar:false;">document.querySelectorAll('.accordion details').forEach(item => {
item.addEventListener('toggle', () => {
if (item.open) {
document.querySelectorAll('.accordion details').forEach(other => {
if (other !== item) other.removeAttribute('open');
});
}
});
});移动端点击没反应?检查是否被 pointer-events: none 拦截
真机上点不展开,大概率是父容器或 <summary></summary>
pointer-events: none(常见于某些 CSS 重置库或 Modal 遮罩层逻辑)。这个属性会让点击穿透,<summary></summary> 完全收不到事件。- 用浏览器开发者工具检查
<summary></summary>计算后的pointer-events值 - 特别留意外层
<div class="modal-content"> 或 <code><section></section>是否意外设置了该样式 - 修复方式:显式设
summary { pointer-events: auto; },或删掉上游的none声明
细节很琐碎:比如 Safari 在 iOS 上对 <summary></summary> 内嵌 <button></button> 有兼容问题,直接放文字最稳。











