原生 HTML 的 details/summary 可实现无 JS/CSS 框架的父子折叠菜单,支持无障碍、键盘操作和多级嵌套;需避免 DOM 干预、合理处理图标与高度动画。

用 details 和 summary 最快实现父子折叠
原生 HTML 就能做,不需要 JS 或 CSS 框架。浏览器支持已很成熟(Chrome 12+、Firefox 49+、Safari 6+、Edge 79+),连无障碍语义都自带。
核心是把父级节点写成 details,子菜单包在内部,用 summary 做点击区域:
<details><summary>菜单项 A</summary><ul>
<li><a href="#a1">子项 A1</a></li>
<li><a href="#a2">子项 A2</a></li>
</ul></details>
-
details默认收起,加open属性可默认展开 -
summary自带小三角图标,CSS 可用::marker控制样式(注意 Safari 目前不支持) - 点击任意位置(包括文字、空白)都会触发展开/收起,无需额外绑定事件
- 键盘支持天然良好:空格/回车切换状态,Tab 可聚焦,屏幕阅读器会读出“已展开”或“已折叠”
需要多级嵌套时怎么写结构
可以无限嵌套 details,但要注意语义层级和视觉可读性。二级菜单直接放在一级的 ul 里即可:
<details><summary>产品中心</summary><ul>
<li><a href="#p1">硬件设备</a></li>
<li>
<details><summary>软件平台</summary><ul>
<li><a href="#s1">管理后台</a></li>
<li><a href="#s2">移动端 App</a></li>
</ul></details>
</li>
</ul></details>
- 不要用
div包裹details再试图控制展开逻辑——那反而破坏原生行为 - 避免在
summary里放button或a,会导致点击冲突或焦点混乱 - 若需禁用某项(比如灰掉的父菜单),加
disabled不生效,得用aria-disabled="true"+ CSS 隐藏箭头 +pointer-events: none
想自定义箭头或去掉默认图标怎么办
CSS 能覆盖大部分样式,但兼容性有差异:
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 隐藏原生箭头:
summary::marker { display: none; }(Chrome/Firefox 支持;Safari 忽略,需用list-style: none+position: relative手动加伪元素) - 加自定义图标:用
summary::before,配合details[open] summary::before切换旋转或内容 - 调整 summary 行高/内边距时,注意别压住箭头区域(尤其 Safari 中箭头是右对齐且固定宽度)
- 不要给
details设height或overflow: hidden,会卡住动画或截断内容
遇到展开后高度错乱或滚动条异常
这是最常被忽略的点:原生 details 展开时没有 CSS 过渡,高度是“瞬间撑开”的。如果子菜单里有图片、异步加载内容或动态计算高度的组件(比如某些 UI 库的 Dropdown),可能造成布局抖动或滚动条闪现。
- 确保子内容在
details渲染完成后再插入——比如等img的load事件,或用requestAnimationFrame延迟操作 - 若必须加过渡效果,只能用
max-height+transition模拟,但要预设足够大的max-height值,否则会切掉长列表 - 在 Web Components 或 React/Vue 中使用时,注意框架可能重写
details的 DOM 结构(比如加 wrapperdiv),导致原生行为失效
真正麻烦的从来不是怎么展开,而是展开之后内容还没准备好,或者被别的 CSS 规则悄悄改了 display 或 visibility。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










