Bootstrap 5.3 导航栏汉堡菜单无法折叠的解决方法

胖宇大大_3882

胖宇大大_3882

2026-09-09

850人浏览

原创

Bootstrap 5.3 导航栏汉堡菜单无法折叠的解决方法

Bootstrap 5.3 中 navbar 折叠失效,通常因重复引入 JS 文件(如同时加载 bootstrap.bundle.min.js 和 bootstrap.min.js + popper.min.js)导致冲突,需确保仅使用其中一种加载方式。

bootstrap 5.3 中 navbar 折叠失效,通常因重复引入 js 文件(如同时加载 `bootstrap.bundle.min.js` 和 `bootstrap.min.js` + `popper.min.js`)导致冲突,需确保仅使用其中一种加载方式。

在 Bootstrap 5.3 中,navbar 的响应式折叠功能(即移动端汉堡菜单点击展开/收起)依赖于 JavaScript 的 Collapse 插件,而该插件又强依赖 Popper(用于定位类组件)和 Bootstrap 自身的初始化逻辑。你提供的代码中存在一个关键性错误:重复且冲突地加载了三份 Bootstrap 相关脚本:

<!-- ❌ 错误:三者共存 → 冲突! -->
<script defer src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script><script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js"></script><script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.min.js"></script>

这会导致:

  • bootstrap.bundle.min.js 已内置 Popper,再额外加载 popper.min.js 和 bootstrap.min.js 会引发全局对象(如 Bootstrap.Collapse)被多次定义或覆盖;
  • 浏览器控制台可能无明显报错,但事件监听器未正确绑定,导致 data-bs-toggle="collapse" 完全失活;
  • 点击汉堡图标后 DOM 无任何变化(aria-expanded 不切换、show 类不添加、#navbarNav 不显示)。

✅ 正确做法:二选一,不可共存

✅ 方案一(推荐):仅使用 bootstrap.bundle.min.js

它已打包 Popper + Bootstrap 核心 JS,开箱即用,简洁可靠:

<!-- ✅ 正确:移除其他 JS,只保留这一行 -->
<script defer src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js" integrity="sha384-YvpcrYf0tY3lHB60NNkmXc5s9fDVZLESaAA55NDzOxhy9GkcIdslK1eN7N6jIeHz" crossorigin="anonymous"></script>

⚠️ 注意:bootstrap.bundle.min.js 必须在 <nav></nav> 结构之后加载(你已用 defer,符合要求),且不能再引入 bootstrap.min.js 或单独的 popper.min.js。

VPS Bootstrap
VPS Bootstrap

从零启动全新 VPS,完成 OpenClaw 完整部署,包括备份/恢复及恢复后验证。用于 OpenClaw 部署。

下载

✅ 方案二(进阶):分离加载 bootstrap.min.js + popper.min.js

仅当你有特殊需求(如需定制 Popper 版本、或项目构建流程强制分离依赖)时选用:

<!-- ✅ 正确:严格按顺序加载,且不引入 bundle -->
<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js" integrity="sha384-I7E8VVD/ismYTF4hNIPjVp/Zjvgyol6VFvRkX/vR+Vc4jQkC+hVqc2pM8ODewa9r" crossorigin="anonymous"></script><script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.min.js" integrity="sha384-0pUGZvbkm6XF6gxjEnlmuGrJXVbNuzT9qBBavbLwCsOGabYfZo0T0to5eqruptLy" crossorigin="anonymous"></script>

? 关键顺序:Popper 必须在 Bootstrap JS 之前加载,否则 Collapse 初始化失败。

✅ 补充检查项(常被忽略)

  1. HTML 结构完整性:你的 <nav></nav> 代码位于 内 —— 这是严重错误!Navbar 必须放在 中,否则 JS 无法找到目标元素 #navbarNav。
  2. data-bs-target 指向正确:确认 id="navbarNav" 与 data-bs-target="#navbarNav" 完全一致(含 #)。
  3. 无 CSS 干扰:检查是否自定义 CSS 错误设置了 display: none !important 或 visibility: hidden 覆盖了 .show 类。

✅ 修复后的最小可运行示例



  <meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>Bootstrap Navbar Fix</title><link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet"><!-- ✅ Navbar 必须在 body 内 --><nav class="navbar navbar-expand-sm navbar-light bg-light"><div class="container-fluid">
      <a href="#" class="navbar-brand">Logo</a>
      <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
        <span class="navbar-toggler-icon"></span>
      </button>
      <div class="collapse navbar-collapse" id="navbarNav">
        <ul class="navbar-nav">
<li class="nav-item"><a class="nav-link active" href="#">Home</a></li>
          <li class="nav-item"><a class="nav-link" href="#">About</a></li>
          <li class="nav-item"><a class="nav-link" href="#">Contact</a></li>
        </ul>
</div>
    </div>
  </nav><!-- ✅ 只加载 bundle,且置于 body 底部或使用 defer --><script defer src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>

? 总结:Bootstrap 5.3 的折叠菜单失效,90% 源于 JS 加载冲突或 HTML 结构错位。优先选择 bootstrap.bundle.min.js 单文件方案,确保其唯一性、位置正确(body 内 + script 在 navbar 后),即可彻底解决汉堡菜单无响应问题。

相关专题

更多
html版权符号
html版权符号

html版权符号是“©”,可以在html源文件中直接输入或者从word中复制粘贴过来,php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

5815

7

html在线编辑器
html在线编辑器

html在线编辑器是用于在线编辑的工具,编辑的内容是基于HTML的文档。它经常被应用于留言板留言、论坛发贴、Blog编写日志或等需要用户输入普通HTML的地方,是Web应用的常用模块之一。php中文网为大家带来了html在线编辑器的相关教程、以及相关文章等内容,供大家免费下载使用。

2023.06.21

3292

4

html网页制作
html网页制作

html网页制作是指使用超文本标记语言来设计和创建网页的过程,html是一种标记语言,它使用标记来描述文档结构和语义,并定义了网页中的各种元素和内容的呈现方式。本专题为大家提供html网页制作的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.31

2970

5

html空格
html空格

html空格是一种用于在网页中添加间隔和对齐文本的特殊字符,被用于在网页中插入额外的空间,以改变元素之间的排列和对齐方式。本专题为大家提供html空格的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.01

2979

5

html是什么
html是什么

HTML是一种标准标记语言,用于创建和呈现网页的结构和内容,是互联网发展的基石,为网页开发提供了丰富的功能和灵活性。本专题为大家提供html相关的各种文章、以及下载和课程。

2023.08.11

4799

6

html字体大小怎么设置
html字体大小怎么设置

在网页设计中,字体大小的选择是至关重要的。合理的字体大小不仅可以提升网页的可读性,还能够影响用户对网页整体布局的感知。php中文网将介绍一些常用的方法和技巧,帮助您在HTML中设置合适的字体大小。

2023.08.11

2941

3

html转txt
html转txt

html转txt的方法有使用文本编辑器、使用在线转换工具和使用Python编程。本专题为大家提供html转txt相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

2729

3

html文本框代码怎么写
html文本框代码怎么写

html文本框代码:1、单行文本框【<input type="text" style="height:..;width:..;" />】;2、多行文本框【textarea style=";height:;"></textare】。

2023.09.01

2428

6

HTML嵌入CSS样式的方法
HTML嵌入CSS样式的方法

HTML嵌入CSS样式的方法有内联样式、内部样式表和外部样式表。本专题为大家提供CSS样式相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.20

2468

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap5 入门教程
Bootstrap5 入门教程

共0课时 | 0人学习

Bootstrap Components 组件文档
Bootstrap Components 组件文档

共0课时 | 0人学习

Bootstrap Grid 栅格系统
Bootstrap Grid 栅格系统

共0课时 | 0人学习