Bootstrap 5 折叠菜单需正确使用 collapse 类、data-bs-toggle="collapse" 和 data-bs-target 属性，配合 aria-expanded/aria-controls 提升可访问性；多级菜单应改用 accordion 模式；动画失效常因 height 或 overflow 样式冲突。
直接用 Bootstrap 的 collapse 类就行，但得配对 data-bs-toggle="collapse"
Bootstrap 5 内置的折叠组件不依赖 JS 手动初始化，只要 HTML 结构和属性写对，点击就能收放。关键不是写 CSS，而是用对 Bootstrap 提供的 data 属性和类名。
常见错误是只加了 collapse 类但漏掉触发器上的 data-bs-toggle="collapse"，或者没指定 data-bs-target（或 href）指向目标元素 ID —— 这时点击完全没反应。
-
data-bs-toggle="collapse"必须写在按钮/链接上，不能只写在折叠内容上 -
data-bs-target="#menu-id"和目标元素的id="menu-id"必须严格一致（注意 # 符号只在 data-bs-target 里写） - 目标元素要同时有
collapse和show才默认展开；去掉show就默认收起
折叠菜单需要可访问性？补上 aria-expanded 和 aria-controls
单纯靠 Bootstrap 默认行为，屏幕阅读器可能无法准确播报菜单开关状态。手动补两个 ARIA 属性能显著改善可访问性，而且不增加 JS 负担。
Bootstrap 不自动管理这些属性，得自己写进 HTML：
立即学习“前端免费学习笔记（深入）”；
<button class="navbar-toggler" type="button"
data-bs-toggle="collapse"
data-bs-target="#mainNav"
aria-expanded="false"
aria-controls="mainNav">
<span class="navbar-toggler-icon"></span>
</button>
<p><div class="collapse navbar-collapse" id="mainNav">
<ul class="navbar-nav">
<li class="nav-item"><a class="nav-link" href="#">首页</a></li>
</ul>
</div>注意：aria-expanded 初始值要和目标元素是否带 show 类保持一致；否则会误导辅助技术。
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
想让折叠菜单支持多级嵌套？别硬套 collapse，改用 accordion
原生 collapse 组件只管单个元素的显隐，没法联动控制多个子菜单的开闭。如果导航有二级、三级菜单，直接堆 data-bs-toggle="collapse" 会导致点开一个，其他还开着，体验混乱。
这时应该换用 Bootstrap 的 accordion 模式，它天然支持「一次只开一个」，还能通过 data-bs-parent 指定作用域：
- 外层容器加
class="accordion"和唯一 ID（如id="nav-accordion"） - 每个菜单项用
class="accordion-item"包裹 - 触发按钮加
data-bs-toggle="collapse"+data-bs-parent="#nav-accordion" - 子菜单内容加
class="accordion-collapse collapse"，并确保id和data-bs-target对应
这样点开二级菜单时，同级其他二级菜单会自动收起，逻辑清晰，不用写一行 JS。
折叠动画卡顿或不生效？检查是否漏了 height 或 overflow 相关样式
Bootstrap 的折叠动画依赖 CSS transition 和 height 变化。如果目标元素内部有浮动子元素、绝对定位内容，或设置了 height: auto 以外的固定高度，动画就会失效或跳变。
典型表现：菜单瞬间出现/消失，没有淡入淡出或高度过渡效果。
- 避免给
.collapse元素直接设height（除非是精确像素值且你知道后果） - 不要给折叠内容加
overflow: hidden以外的overflow值（比如scroll会破坏动画） - 如果子元素用了
float或display: inline-block，建议改用flex或grid布局，避免清除浮动干扰高度计算
最稳妥的方式是让折叠内容用纯流式布局，由 Bootstrap 自动计算 height 过渡值。
