讲师中心 微信公众号
AI工具推荐 视频效率加速

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

老宇大大_4180

老宇大大_4180

发布时间:2026-09-10 22:33:43

|

617人浏览过

|

来源于php中文网

原创

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

Bootstrap 5.3 中 navbar 汉堡菜单失效,通常源于 JavaScript 文件重复加载导致的冲突——特别是同时引入 bootstrap.bundle.min.js、bootstrap.min.js 和 popper.min.js 三者,破坏了 Collapse 组件的正常初始化。

bootstrap 5.3 中 navbar 汉堡菜单失效,通常源于 javascript 文件重复加载导致的冲突——特别是同时引入 `bootstrap.bundle.min.js`、`bootstrap.min.js` 和 `popper.min.js` 三者,破坏了 collapse 组件的正常初始化。

在 Bootstrap 5.3+ 中,navbar 的响应式折叠功能(即点击汉堡图标展开/收起导航项)依赖于 Collapse JavaScript 插件,该插件需要正确初始化且无运行时冲突。你提供的代码中存在一个关键问题:重复引入了互斥的 Bootstrap JS 资源

<!-- ❌ 错误:三者共存 → 冲突! -->
<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.js 和所有 Bootstrap JS 插件(包括 CollapseDropdownModal 等)。而 bootstrap.min.js 是“精简版”,不包含 Popper,必须配合外部 Popper 才能工作。当三者同时加载时:

  • bootstrap.bundle.min.js 首先注册全局 bootstrap 对象并初始化 Collapse;
  • 后续 bootstrap.min.js 会覆盖或干扰已注册的模块;
  • Popper 的重复加载更可能引发 TypeError: Popper is not a constructor 等静默错误;
  • 最终导致 data-bs-toggle="collapse" 失效,点击无响应。

正确做法:二选一,且仅选其一

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

简洁、可靠、零配置,适合绝大多数项目:

Bootstrap
Bootstrap

Bootstrap 5.3.8 编译版包含可直接用于项目的 CSS、JavaScript 和插件文件,适合快速搭建响应式网页。

下载
<!-- ✅ 正确:移除 popper.min.js 和 bootstrap.min.js -->
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">
<script defer src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>

? 注意:defer 属性可保留,确保脚本在 DOM 解析后执行,不影响 Collapse 初始化。

✅ 方案二(按需定制):bootstrap.min.js + popper.min.js

仅当你需独立升级 Popper、或明确排除某些插件以减小体积时选用(极少见):

<!-- ✅ 正确:严格顺序 + 无 bundle -->
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">
<script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.8/dist/umd/popper.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.min.js"></script>

⚠️ 关键要求:popper.min.js 必须在 bootstrap.min.js 之前加载,否则 Collapse 将因缺少依赖而静默失败。

? 额外检查项(确保万无一失)

  1. HTML 结构完整性:确认 <nav></nav> 内,且 id="navbarNav"data-bs-target="#navbarNav" 完全匹配(含 #);
  2. 无 JS 控制台报错:打开浏览器开发者工具(F12 → Console),刷新页面,排查 Uncaught TypeErrorPopper is not defined
  3. CSS 未被覆盖:检查是否自定义 CSS 错误设置了 .navbar-collapse { display: block !important; } 等强制样式;
  4. Bootstrap 版本一致性:CDN 中 CSS 与 JS 的 @5.3.3 版本号必须完全一致(你的代码中 JS 是 5.3.3,但 CSS URL 未显示版本号,请补全为 @5.3.3)。

✅ 修复后完整最小可运行示例

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Bootstrap Navbar Fix</title>
  <!-- Bootstrap CSS (v5.3.3) -->
  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<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 Us</a></li>
          <li class="nav-item"><a class="nav-link" href="#">Courses</a></li>
        </ul>
      </div>
    </div>
  </nav>

  <!-- Bootstrap JS (bundle only) -->
  <script defer src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/js/bootstrap.bundle.min.js"></script>
</body>
</html>

✅ 总结:删掉多余的 JS 引入,只保留 bootstrap.bundle.min.js,即可 99% 解决汉堡菜单不折叠问题。 这是 Bootstrap 5.3 官方推荐的标准实践,兼顾稳定性、兼容性与开发效率。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

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

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

4915

2023.06.14

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

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

2872

2023.06.21

html网页制作
html网页制作

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

2550

2023.07.31

html空格
html空格

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

2579

2023.08.01

html是什么
html是什么

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

4539

2023.08.11

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

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

2521

2023.08.11

html转txt
html转txt

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

2309

2023.08.31

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

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

2128

2023.09.01

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

0

2026.09.23

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn