details 元素的 toggle 事件不提供 newState 或 oldState,仅可通过 e.target.open 获取最新布尔状态;该事件仅由用户点击 summary 触发,JS 修改 open 不会触发,需用 addEventListener 绑定。

details 元素的 toggle 事件不提供 newState 或 oldState
浏览器原生 toggle 事件**没有 newState、oldState 或 detail 属性**。很多人搜“toggle event newState”后试图读 e.detail,结果发现它始终是 undefined——这不是你代码写错了,是规范就没定义这个字段。
真正可用的状态信号只有一个:e.target.open,它在事件触发时已同步更新为最新值。也就是说,你不需要“推断”新状态,它就摆在那儿。
-
e.target是<details></details>元素本身(不是<summary></summary>) - 事件只在用户点击
<summary></summary>时触发,JS 直接改open属性不会触发 - 不要用
onToggle内联属性,必须用addEventListener('toggle', ...)
如何安全判断展开还是收起
直接读 e.target.open 就是最简、最可靠的方式。注意:它返回布尔值,不是字符串。
const details = document.querySelector('details');
details.addEventListener('toggle', (e) => {
if (e.target.open) {
console.log('已展开');
} else {
console.log('已收起');
}
});
- 别写成
e.target.getAttribute('open') !== null—— 这会漏掉 JS 设置的布尔值状态 - 别依赖事件触发前的 DOM 状态(比如缓存一个变量去比对),因为
open属性在事件回调执行时已更新 - 多个
<details></details>可批量绑定:document.querySelectorAll('details').forEach(d => d.addEventListener('toggle', handler))
需要统一处理 JS 和用户交互?自己封装状态切换逻辑
如果你既允许用户点击 <summary></summary>,又需要 JS 主动调用开闭(比如页面加载时恢复状态),那么原生 toggle 事件就不够用了——它根本不会响应 JS 设置 open 的行为。
立即学习“前端免费学习笔记(深入)”;
这时得把状态变更收口到一个函数里:
function setDetailsOpen(details, isOpen) {
details.open = isOpen;
// 手动触发你的业务逻辑
if (isOpen) {
console.log('手动设为展开');
} else {
console.log('手动设为收起');
}
}
- 所有开闭操作都走
setDetailsOpen(),避免混用原生交互和 JS 赋值 - 如果必须监听“任何方式导致的状态变化”,就放弃依赖
toggle事件,改用MutationObserver监听open属性变化(但性能和复杂度会上升) - 不要在
toggle回调里再调用setDetailsOpen(),会造成重复执行
popover 的 toggle 事件有 newState,但仅限于 popover
和 <details></details> 不同,<div popover> 的 <code>toggle 事件确实带 newState 属性:
const popover = document.getElementById('myPopover');
popover.addEventListener('toggle', (e) => {
console.log(e.newState); // 'open' 或 'closed'
});
-
e.newState是字符串,不是布尔值 - 该 API 仅适用于
popover,不适用于details,别跨元素复用逻辑 - 目前仅 Chromium 系(Chrome/Edge)稳定支持,Firefox 尚未实现,Safari 无计划(截至 2026 年 10 月)
details 的 toggle 事件不派发旧状态,也不保证事件顺序与 DOM 更新严格同步——它只承诺“状态已变”,而 e.target.open 就是那个已变的结果。别想从事件对象里挖出更多东西,那不存在。



















