必须是的首个直接子元素,否则点击失效;自定义箭头需用summary::before,动画靠max-height过渡,JS仅用于URL参数或导航联动,监听toggle事件获取状态。

直接用 <details></details> + <summary></summary> 就能实现,不需要写一行 JS,但必须确保 <summary></summary> 是 <details></details> 的第一个子元素,否则点不动。
为什么点一下没反应?常见结构错误
最常踩的坑是 DOM 结构不合规:<summary></summary> 前不能有空格、换行、注释或任何其他节点。浏览器只认“紧贴 <details></details> 开始标签后的第一个子元素”为有效触发器。
- ❌ 错误写法:
<details><!-- 注释 --><summary>标题</summary>...</details> - ❌ 错误写法:
<details><div></div> <summary>标题</summary>...</details> - ✅ 正确写法:
<details><summary>标题</summary><p>内容</p></details>
微信或 QQ 内置 WebView(尤其安卓旧版)可能完全忽略 open 属性,真机测试不可跳过。
立即学习“前端免费学习笔记(深入)”;
怎么自定义箭头和展开动画?
原生箭头无法用 CSS 直接改高度/颜色,但可用伪元素覆盖。动画只能靠 max-height 模拟,因为 height: auto 不支持 CSS 过渡。
- Safari 不支持
summary::marker,得用summary::before+content插入 SVG 或 Unicode - Chrome/Firefox 可用
summary::marker { content: "▼"; }替换默认三角 - 加动画要写两段 CSS:
details[open] .content { max-height: 300px; }和.content { max-height: 0; overflow: hidden; transition: max-height 0.25s ease-in-out; } - 300px 是预估最大高度,设太小会截断,太大动画变慢
需要 JS 控制初始状态或联动时怎么做?
只有两种合理场景值得用 JS:URL 参数决定默认展开(如 ?faq=3),或点击导航菜单时自动展开对应 <details></details>。别为了“加个动效”强行接管 open 属性。
- 设默认展开:
<details open><summary>...</summary></details> - JS 控制展开(兼容 Safari 15.4 之前):
el.setAttribute('open', ''),别用el.open = true - 监听展开事件:
el.addEventListener('toggle', () => console.log(el.open)) - 禁止在
<summary></summary>里放<button></button>或设pointer-events: none,否则整个区域失活
真正难的不是写代码,而是判断该不该用 JS——<details></details> 已经处理了键盘焦点、ARIA 状态、空格/回车触发,手动实现极易漏掉可访问性链路。如果项目必须支持 IE,才考虑降级方案。



















