原生 details/summary 标签最快实现折叠菜单,无需 JS;summary 必须是 details 的第一个子元素,支持 ARIA、键盘操作及默认展开(open 属性),隐藏箭头用 summary::marker{content:""},不兼容 IE。

用 details 和 summary 最快实现原生折叠菜单
不用写 JS,不依赖框架,HTML5 原生就支持。浏览器点一下 summary 标签,details 里的内容自动展开/收起,还自带 ARIA 属性和键盘支持(空格/回车触发)。
常见错误是把 summary 写成普通 div 或加了 display: block 覆盖默认样式,导致点击失效;或者在 summary 外层再套一层标签,破坏语义结构。
实操建议:
-
summary必须是details的**第一个子元素**,且不能嵌套另一个details - 默认展开?加
open属性: - 想隐藏默认箭头?用 CSS
summary::marker { content: "" },但别用display: none,否则可访问性丢失 - 不支持 IE,Edge 79+、Chrome 12+、Firefox 49+ 都 OK
需要兼容 IE 或自定义动画?得用 JS 控制 max-height
纯 CSS 动画方案本质是控制 max-height 从 0 到一个足够大的值(比如 500px),配合 overflow: hidden。不能用 height: 0 → auto,因为 auto 无法参与 CSS 过渡。
容易踩的坑:
- 设死的
max-height值太小:内容被截断;太大:动画慢且不精准 - 没重置
max-height到none:JS 动态增删内容后高度错乱 - 没处理过渡结束事件(
transitionend):连续快速点击时状态不同步
简单示例逻辑:
const toggleBtn = document.querySelector('.menu-toggle');
const menu = document.querySelector('.submenu');
toggleBtn.addEventListener('click', () => {
const isOpen = menu.style.maxHeight;
if (isOpen) {
menu.style.maxHeight = '0';
} else {
menu.style.maxHeight = menu.scrollHeight + 'px';
}
});
// transitionend 后设为 'none' 避免影响后续 JS 计算
menu.addEventListener('transitionend', () => {
if (menu.style.maxHeight === '0px') {
menu.style.maxHeight = 'none';
}
});
Vue/React 里别手动操作 DOM,用响应式状态驱动
在 Vue 中直接绑定 v-show 或 v-if,React 用 useState 控制是否渲染或添加 class。手动查 DOM、改 style 不仅冗余,还会和框架生命周期冲突(比如组件卸载后 JS 还在监听事件)。
关键差异:
-
v-show/display: none:保留 DOM,切换快,适合频繁开关 -
v-if/ 条件渲染:彻底销毁重建,适合内容多或初始化开销大 - 加动画?Vue 用
包裹,React 推荐framer-motion或react-transition-group,别自己写setTimeout
移动端点击区域太小?重点调 summary 或按钮的 padding 和 min-height
手指操作需要至少 44×44px 的触控区。原生 summary 默认只有文字高度,iOS Safari 下经常点不中。这不是 JS 问题,是 CSS 布局问题。
解决方式很直接:
- 给
summary加padding: 12px 16px,并设min-height: 44px - 用
box-sizing: border-box防止 padding 撑大容器 - 避免只靠
font-size放大文字来凑尺寸——文字变大但点击热区没变 - 如果用了自定义按钮(非
summary),务必加role="button"和tabindex="0"保证键盘可访问
折叠菜单看着简单,但跨浏览器行为、动画精度、可访问性和响应式触控是连环问题。别一上来就写 JS,先看原生 details 能不能覆盖主场景;要动效就老实用 max-height 过渡;框架里就彻底交给状态管理——手撕 DOM 很容易在 resize、服务端渲染或焦点管理上翻车。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











