Bootstrap 5 导航栏点击链接后不自动收起,因默认无“跳转即收起”逻辑;需为.nav-link添加data-bs-toggle="collapse"和data-bs-target=".navbar-collapse.show"触发精准收起。

Bootstrap 5 的 navbar 折叠逻辑依赖 data-bs-toggle="collapse"
Bootstrap 5 默认不自动折叠手机端导航栏,必须手动添加折叠触发结构。核心是:一个带 常见错误是只写了 这些 ARIA 属性不是装饰,而是让屏幕阅读器知道按钮状态和它控制哪个区域。Bootstrap JS 会自动切换 另外, Bootstrap 用 常见翻车操作: 如果页面没加载 验证方法:打开开发者工具,在 Console 输入 容易被忽略的是:某些构建工具(如 Vite)默认不处理 data-bs-toggle="collapse" 的按钮,和一个用 id 匹配的 navbar-expand-sm 也不会收起菜单。 却漏掉 data-bs-target(或写成 href)或者目标 collapse 类——这时点击没反应,控制台也无报错,纯静默失效。
data-bs-target 必须是 CSS 选择器(如 #navbarNav),不能只写 navbarNav
collapse 和 navbar-collapse 两个类,缺一不可
navbar-expand-lg,那在 lg 及更大断点下菜单永远展开,小屏才折叠;改用 navbar-expand-md 或 navbar-expand-sm 可提前触发折叠折叠按钮的
aria-expanded 和 aria-controls 不是可选的aria-expanded 值(true/false),但前提是 HTML 结构正确。如果手写时删掉了 aria-controls="navbarNav",语音辅助工具就无法关联按钮和菜单,对无障碍用户直接不可用。navbar-toggler-icon 是 SVG 图标,不是文字,所以必须靠 ARIA 属性说明功能。别用 title 或注释代替。自定义折叠动画?别动
collapsing 过渡类collapsing(过渡中)、collapse(收起)、show(展开)三个类控制状态。想改动画时长或 easing,应该覆盖 CSS 中 .navbar-collapse.collapse 的 transition,而不是删掉 collapsing 类或重写 JS。
.navbar-collapse 加 display: none —— 会破坏 JS 的高度计算,导致闪退或卡住!important 强制设置 max-height —— 和 Bootstrap 的 JS 高度测量冲突collapsing 类名试图“简化” —— 动画立刻消失,变成硬切JS 初始化失败时,折叠完全不工作
bootstrap.bundle.min.js(注意是 bundle 版,含 Popper),或者加载顺序在 jQuery 之后(Bootstrap 5 已不依赖 jQuery,但有人误留旧引用造成冲突),data-bs-toggle 就不会绑定事件。此时按钮点击毫无反应,连控制台警告都没有。bootstrap,看是否返回对象;再查 Elements 面板里按钮是否有 data-bs-toggle,目标 id 且拼写一致。data-* 属性,需确认 HTML 模板是否原样输出了这些属性。











