details 元素的 toggle 事件仅在用户点击 summary 时触发,不响应 JS 修改 open 属性,且不冒泡;必须用 addEventListener('toggle', ...) 监听,通过 e.target.open 判断状态,不支持内联绑定或 beforetoggle。

details 元素的 toggle 事件根本不会自动触发
很多人在查 MDN 或搜 “details toggle event” 后,直接写 onbeforetoggle 或 ontoggle 属性,结果回调完全不执行——因为浏览器压根不支持内联绑定,也不派发名为 toggle 的自定义事件。真实情况是:details 原生只支持用 addEventListener('toggle', ...) 显式监听,且仅在用户点击 summary 时触发。
常见错误现象包括:
- 写了
<details ontoggle="handle()>,但函数从不调用 - 用 JS 设置
details.open = true后,期望toggle事件触发,结果静默失败 - 把事件委托到父容器,发现监听不到——因为
toggle不冒泡
正确监听 toggle 事件只需三步
核心逻辑就是注册 + 判断 e.target.open,别依赖 e.detail(它永远是 undefined)。
实操建议:



















