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

直接用 + 就能实现,不需要写一行 JS,但必须确保 是 的第一个子元素,否则点不动。
为什么点一下没反应?常见结构错误
最常踩的坑是 DOM 结构不合规: 前不能有空格、换行、注释或任何其他节点。浏览器只认“紧贴 开始标签后的第一个子元素”为有效触发器。
- ❌ 错误写法:
标题
... - ❌ 错误写法:
标题
... - ✅ 正确写法:
标题
内容
微信或 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),或点击导航菜单时自动展开对应 。别为了“加个动效”强行接管 open 属性。
- 设默认展开:
...
- JS 控制展开(兼容 Safari 15.4 之前):
el.setAttribute('open', ''),别用el.open = true - 监听展开事件:
el.addEventListener('toggle', () => console.log(el.open)) - 禁止在
里放或设pointer-events: none,否则整个区域失活
真正难的不是写代码,而是判断该不该用 JS—— 已经处理了键盘焦点、ARIA 状态、空格/回车触发,手动实现极易漏掉可访问性链路。如果项目必须支持 IE,才考虑降级方案。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











