details元素不支持ontoggle内联属性，必须用addEventListener('toggle', handler)监听；事件仅响应用户操作，JS修改open不触发；读取状态应优先用hasAttribute('open')。
details元素没有ontoggle属性，必须用addEventListener('toggle')
很多人搜“ontoggle”想写<details ontoggle="track()"></details>，这行不通。浏览器根本不解析ontoggle这个内联属性，也不会调用任何函数。它不是兼容性问题，是规范层面不支持——<details></details>压根没定义这个 HTML 属性。
正确做法只有一条路径：选中<details></details>元素，调用addEventListener('toggle', handler)。注意字符串是'toggle'，不是'ontoggle'、'onToggle'，也不是'Toggle'。
- 监听对象必须是
<details></details>本身，不能绑在<summary></summary>或父容器上 -
toggle事件不冒泡，无法委托到祖先节点 - IE 和 Edge ≤18 完全不支持；Safari ≤15.4 有延迟或丢失，需降级兜底
toggle事件只响应用户操作，JS改open不触发
这是最常踩的坑：details.open = true、details.setAttribute('open', '')、甚至details.toggleAttribute('open')，全都**不会触发toggle事件**。该事件仅在用户点击<summary></summary>、按空格键或回车键时派发。
如果你既要响应用户点击，又要统一处理所有开闭逻辑（比如存 localStorage、联动其他面板），就得自己封装控制函数：
立即学习“前端免费学习笔记（深入）”；
function setDetailsOpen(detailsEl, isOpen) {
detailsEl.open = isOpen;
// 手动派发 toggle 事件，模拟用户行为
const event = new Event('toggle', { bubbles: false });
Object.defineProperty(event, 'target', { value: detailsEl });
Object.defineProperty(event, 'newState', { value: isOpen ? 'open' : 'closed' });
detailsEl.dispatchEvent(event);
}
- 别在
toggle回调里再执行details.open = ...，否则可能引发状态冲突或循环 - 若需手风琴效果（单开），应在回调中手动设置其他
<details></details>的open属性，但它们的toggle事件不会被触发——这是预期行为
读取状态别直接用event.target.open，优先hasAttribute('open')
toggle事件触发时，event.target.open确实已更新为新值，但在 SSR 渲染 + JS 补充监听的场景下，DOM 可能尚未完成重排，直接读可能拿到旧状态。尤其在 Safari 15.4 或部分安卓 WebView 中，误判率明显升高。
更可靠的方式是检查 DOM 属性是否存在：
- ✅ 推荐：
details.hasAttribute('open')—— 反映真实渲染层状态 - ⚠️ 慎用：
details.open—— 是 DOM 属性，受 JS 同步赋值影响，但可能滞后于视觉 - ❌ 避免：
if (e.target.open) { ... }—— 在弱网或旧版环境中容易错判
埋点参数建议包含上下文标识，比如每个<details data-id="faq-2"></details>，上报时带{ event: 'details_toggle', id: details.dataset.id, open: details.hasAttribute('open') }。
多个details共存时，避免重复绑定和状态干扰
页面有 FAQ 列表或配置面板时，可以批量绑定监听器，但要注意两点：
- 每个
<details></details>应独立监听，不要靠一个父级委托——toggle不冒泡，委托无效 - 如果需要联动（如单选折叠），关闭其他项时，不要在当前
toggle回调里立刻修改其他details.open，而应等当前动画帧结束（用requestAnimationFrame包裹）再操作，否则 Safari 下可能出现视觉跳变 - 动态插入的
<details></details>需在插入后立即绑定监听，不能依赖事件委托
复杂点在于：动画、SSR、localStorage 持久化三者叠加时，状态还原顺序极易出错——open 属性必须在 CSS 动画初始化前设置，否则会跳过过渡直接硬展开。
