toggle事件仅在details状态变更时触发，不能用于统计总点击次数；必须监听summary的click事件并手动计数，同时支持键盘操作与可访问性行为。
details 标签本身不提供“点击次数”统计，它只触发一次 toggle 事件（状态切换时），不是每次点击都触发。想统计用户对某个 details 的**总点击次数**，必须自己维护计数器，不能依赖事件频次。
为什么 toggle 事件不能直接当点击计数用
浏览器规范明确：一个 details 元素在状态不变时重复点击 summary，toggle 事件不会重复触发。例如：已展开状态下连续点 5 次 summary，只在第一次收起时触发一次 toggle；之后保持收起再点，也只在第一次展开时触发。它反映的是“状态变更”，不是“用户动作次数”。
常见误判现象：
- 埋点看到某 details 的 toggle 事件日志只有 1 条，但用户实际点了 10 次
- 用 e.target.open 判断后做计数，结果数字远低于真实交互频次
正确做法：监听 click 事件并手动计数
要统计真实点击次数，必须监听 summary 的 click 事件，并在回调中递增变量或写入 localStorage。注意避开以下陷阱：
-
summary是唯一合法触发区，不要监听整个details—— 点击折叠内容区域不会触发 - 键盘操作（空格/回车）也会触发
click，无需额外处理，浏览器已兼容 - 避免重复绑定：如果 JS 动态插入多个
details，应统一用事件委托，或确保每个summary只绑一次 - 若需持久化（如跨页面保留计数），用
localStorage.setItem('details-click-count', count)，但注意同域限制和存储大小（5MB）
示例代码：
立即学习“前端免费学习笔记（深入）”；
const summary = document.querySelector('details > summary');
let clickCount = parseInt(localStorage.getItem('faq-click-count') || '0');
<p>summary.addEventListener('click', () => {
clickCount += 1;
localStorage.setItem('faq-click-count', clickCount);
console.log('当前点击次数：', clickCount);
});
如何区分“状态切换”和“纯点击”两种埋点需求
很多场景其实需要两类数据同时上报：一是用户是否曾展开过（toggle），二是用户对该区域的活跃度（click）。两者不可互相替代：
- 用
toggle埋点判断功能使用率（比如 70% 用户至少展开过一次 FAQ） - 用
click埋点分析交互强度（比如平均每人点 2.3 次，说明内容有反复查阅需求） - 上报字段建议分离：
{ event: 'details_click', id: 'faq-2' }和{ event: 'details_toggle', id: 'faq-2', open: true } - 注意：
click回调里不要调用details.open = !details.open—— 这会引发冗余状态变更，且不必要
真正容易被忽略的是：details 的可访问性行为（如屏幕阅读器的 enter 键、Mac VoiceOver 的 rotor 切换）也会触发 click，所以你统计的“点击次数”其实是“所有激活行为次数”，这反而是更真实的用户意图指标 —— 别试图过滤它。
