真正能开箱即用、语义正确、无障碍友好的树形展开方案是 元素,它原生支持 toggle 事件且仅作用于自身;ul/li 等普通元素不触发该事件,需用 click 事件配合 aria-expanded 和 max-height 实现手动控制。

toggle 事件不是 HTML 原生事件,也不能直接用在 ul 或 li 上实现树形展开——这是最常见的误解起点。真正能开箱即用、语义正确、无障碍友好的方案,是 <details></details>,它自带 toggle 事件,但仅限于自身元素触发,不适用于手动构造的 ul/li 树。
为什么不能监听 ul 的 toggle 事件
浏览器不会给 ul、li 这类普通元素派发 toggle 事件。你写的 element.addEventListener('toggle', ...) 永远不会执行。这个事件只属于 <details></details> 元素,且仅在其 open 属性切换时触发。
- 试图对
li绑定toggle是无效的,控制台无报错但逻辑不运行 - jQuery 早期有
.toggle()方法(切换显隐),但它已被弃用多年,且和事件无关 - 若你看到“toggle 事件”相关教程,大概率混淆了「事件名」和「动作名」:展开/收起是行为,
toggle是函数名或状态切换动词,不是 DOM 事件类型
details + summary 是唯一带原生 toggle 事件的方案
只有 <details></details> 元素会真实触发 toggle 事件,你可以这样监听:
<details>
<summary>前端工具</summary>
<ul>
<li>Webpack</li>
<li>Vite</li>
</ul>
</details>
<script>
document.querySelector('details').addEventListener('toggle', e => {
console.log('open:', e.target.open); // true/false
});
</script>
注意点:
立即学习“前端免费学习笔记(深入)”;
- 嵌套
<details></details>在部分 Safari 版本中会重置子级open状态,不要依赖多层同时保持展开 -
summary必须是details的第一个子元素,否则点击无效、箭头不显示 - 打印 PDF 时,
open状态会被保留(相比 JS 控制的display更可靠) - 键盘用户按 Space/Enter 可直接触发,无障碍支持开箱即用
如果必须用 ul/li,就别提 toggle 事件
手写树形菜单时,交互核心是点击事件 + 状态管理,不是监听某个叫 toggle 的事件。典型做法是:
- 给每个可展开的
li添加data-expanded="false" - 点击时用
classList.toggle('is-open')切换样式类 - 用
max-height+overflow: hidden做过渡动画(display无法过渡) - 把当前展开状态同步到
aria-expanded属性,满足可访问性要求
示例关键 JS 片段:
document.querySelectorAll('li[data-toggle]').forEach(item => {
item.addEventListener('click', e => {
const ul = item.querySelector('ul');
if (!ul) return;
const isExpanded = item.getAttribute('aria-expanded') === 'true';
item.setAttribute('aria-expanded', String(!isExpanded));
ul.style.maxHeight = isExpanded ? '0' : ul.scrollHeight + 'px';
});
});
这里没有 toggle 事件,只有 click 和手动状态切换。
容易被忽略的缩进与打印兼容问题
无论用 details 还是 ul/li,小屏溢出和 PDF 打印错位才是上线前最常翻车的地方:
- 缩进统一用
margin-left,别用padding-left—— 后者会让点击热区偏移,打印时内边距也参与分页 - 长文本必须加
word-break: break-word,否则中文路径或 URL 会横向撑破容器 - 连线图标必须用伪元素(
::before/::after)绘制,禁用 Unicode 字符(如├)或<img alt="HTML toggle事件制作树形目录展开效果的教程" >—— 它们在 Retina 屏模糊、PDF 中消失、Safari 渲染错位 - 如果目录需初始展开某几项,
details只能靠open属性;ul/li方案则必须在 JS 中遍历并提前设置max-height和aria-expanded



















