语义化嵌套列表是树形菜单HTML骨架的核心:父节点用包裹文字和子,子必须紧贴置于对应内部;需添加aria-expanded属性标识展开状态,避免全局查询DOM,初始展开状态应由HTML固化而非JS注入。

用 <ul></ul> 和 <li> 构建嵌套层级结构
树形菜单的 HTML 骨架必须是语义化的嵌套列表,不能靠 div + 绝对定位硬凑。每个父节点用一个 <li> 包裹文字和子菜单,子菜单就是另一个 <ul></ul>,逐层嵌套即可表达任意深度。
常见错误现象:用多个平级 <ul></ul> 并列写,再靠 JS 手动关联父子关系;或把子菜单写在父 <li> 外面,导致 CSS 无法用 li > ul 精准控制。
- 根菜单项必须是顶层
<ul></ul>的直接子<li> - 每个可展开的父节点,其子
<ul></ul>必须紧贴放在对应<li>内部(不是后面、不是兄弟) - 避免在
<li>里塞<span></span>或<button></button>再额外包一层——点击区域应直接作用于<li>或其内明确的触发器(如带data-toggle的<span></span>)
给父节点加状态标记和可访问性属性
光有结构不够,JS 和屏幕阅读器都需要明确知道哪个节点能展开、当前是否已展开。aria-expanded 是必加属性,比自定义 data- 属性更可靠。
使用场景:键盘用户按 Enter 或 Space 触发展开时,依赖 aria-expanded 值判断行为;自动化测试脚本也常查这个属性做断言。
立即学习“前端免费学习笔记(深入)”;
- 初始状态为折叠的父节点,设
aria-expanded="false",并确保其子<ul></ul>默认隐藏(CSS 控制) - 不要只靠 class 切换(如
is-collapsed)来判断逻辑状态——class 容易漏加/误删,aria-expanded是单一事实源 - 若用
<details></details>快速原型,它自带open属性,但无法手动同步多级状态,且 Safari 下嵌套时子<details></details>的open可能被重置
避免用 querySelectorAll('li > ul') 全局查找子菜单
这是 JS 实现展开逻辑时最常踩的坑:一点击就收起所有子菜单,或点错节点却操作了远房表亲的 <ul></ul>。
性能影响:每次点击都执行全量 DOM 查询,节点多时明显卡顿;逻辑上也违背“只响应当前交互目标”的原则。
- 正确做法是:从被点击的元素出发,用
nextElementSibling或querySelector(':scope > ul')(需支持:scope)找紧邻的子菜单 - 如果结构是
<li> <span class="toggle">标题</span><ul>...</ul> </li>,就用event.target.closest('li').querySelector('ul') - 绝对不要写
document.querySelectorAll('li > ul')然后遍历判断是否属于当前分支——既慢又脆弱
初始展开状态要靠 HTML 结构而非 JS 注入
服务端渲染或静态 HTML 中,某些节点需要默认展开(比如用户上次离开时打开的目录)。这个状态必须在 HTML 输出时就固化,而不是等 JS 加载完再 click() 模拟。
容易被忽略的地方:SPA 应用里,如果路由变化后重新渲染树组件,但没把历史展开状态传入初始数据,就会丢失用户上下文;纯静态页则根本没 JS 介入机会。
- 服务端或构建时,给对应父
<li>加data-expanded="true",JS 初始化时读取并同步aria-expanded和样式 - CSS 里别只写
.is-open > ul { display: block },还要加一条li[data-expanded="true"] > ul { display: block }保底 - localStorage 存的是路径标识(如
["frontend", "javascript", "es6"]),还原时应递归匹配 DOM 节点,而不是靠索引位置——DOM 结构微调就会失效



















