解决 Bootstrap 5 导航栏折叠失效问题：数据属性迁移指南

---

当从 bootstrap 4 升级到 bootstrap 5 时，开发者可能会遇到导航栏折叠功能失效的问题。这通常是由于 bootstrap 5 对 j*ascript 组件的数据属性进行了命名空间调整，将 `data-toggle` 和 `data-target` 替换为 `data-bs-toggle` 和 `data-bs-target`。本文将详细解释这一变化，并提供正确的代码示例，帮助您顺利迁移并修复导航栏折叠功能。

问题概述

在 Bootstrap 5 中，一些核心 J*aScript 组件的数据属性（data attributes）发生了变化，以避免与其他前端库可能存在的命名冲突。其中，导航栏（N*bar）的折叠（Collapse）功能是受影响最明显的组件之一。如果您的代码仍然沿用 Bootstrap 4 的 data-toggle="collapse" 和 data-target="#id" 属性，那么在 Bootstrap 5 环境下，导航栏的切换按钮将无法正常工作，点击后导航菜单不会展开或收起。

Bootstrap 5 数据属性新规

Bootstrap 5 引入了带有 bs 前缀的数据属性，例如 data-bs-toggle 和 data-bs-target。这一改变旨在为 Bootstrap 的 J*aScript 功能提供明确的命名空间，减少与其他库（如 jQuery UI 或其他自定义脚本）发生冲突的可能性。因此，所有依赖这些数据属性的组件，包括导航栏、模态框、折叠面板等，都需要进行相应的更新。

解决方案与示例

要解决 Bootstrap 5 导航栏折叠失效的问题，只需将导航栏切换按钮（n*bar-toggler）上的两个关键数据属性进行更新：

1. 将 data-toggle="collapse" 更改为 data-bs-toggle="collapse"。
2. 将 data-target="#n*barN*AltMarkup" 更改为 data-bs-target="#n*barN*AltMarkup"。

以下是一个修正后的 Bootstrap 5 导航栏示例代码：

Magician

Figma插件，AI生成图标、图片和UX文案

412 查看详情

<!doctype html>
<html lang="sr">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, user-scalable=false, initial-scale=1">
    <link rel="icon" href="{{ url_for('static', path='/images/f*icon.png') }}" sizes="32x32" />

    <!-- Bootstrap CSS -->
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" integrity="sha384-Zenh87qX5JnK2Jl0vWa8Ck2rdkQ2Bzep5IDxbcnCeuOxjzrPF/et3URy9Bv1WTRi" crossorigin="anonymous">
    <title>N*bar Test</title>
  </head>
  <body>
    <!-- 推荐使用 Bootstrap Bundle，因为它包含了 Popper.js -->
    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js" integrity="sha384-geWF76RCwLtnZ8qwWowPQNguL3RmwHVBC9FhGdlKrxdiJJigb/j/68SIy3Te4Bkz" crossorigin="anonymous"></script>

    <div class="container">
        <n* class="n*bar n*bar-expand-lg n*bar-light bg-light">
            <!-- 关键修改：data-bs-toggle 和 data-bs-target -->
            <button class="n*bar-toggler collapsed" type="button" data-bs-toggle="collapse" data-bs-target="#n*barN*AltMarkup" aria-controls="n*barN*AltMarkup" aria-expanded="false" aria-label="Toggle n*igation">
                <span class="n*bar-toggler-icon"></span>
            </button>
            <div class="n*bar-collapse collapse" id="n*barN*AltMarkup">
                <div class="n*bar-n*">
                    <a class="n*-item n*-link active" href="/">Home</a>
                    <a class="n*-item n*-link" href="/link1">Link 1</a>
                    <a class="n*-item n*-link" href="/link2">Link 2</a>
                    <div class="dropdown">
                        <a class="n*-item n*-link dropdown-toggle" href="#" role="button" id="dropdownMenuReports" data-bs-toggle="dropdown" aria-expanded="false">
                          Reports
                        </a>

                        <ul class="dropdown-menu" aria-labelledby="dropdownMenuReports">
                          <li><a class="dropdown-item" href="/reports/reminders">Reminders - Send</a></li>
                          <li><a class="dropdown-item" href="/reports/reminders?render_only">Reminders - Display Only</a></li>
                        </ul>
                      </div>
                </div>
            </div>
        </n*>
    </div>
  </body>
</html>

在上述代码中，我们移除了 jQuery 和 Popper.js 的单独引入，而是直接使用了 Bootstrap 5 提供的 bootstrap.bundle.min.js。这个文件已经包含了所有 Bootstrap J*aScript 组件及其依赖（包括 Popper.js），是推荐的引入方式，可以简化管理并确保兼容性。

注意事项

1. 完整引入 Bootstrap 5 JS： 确保您引入的是 bootstrap.bundle.min.js。这个文件包含了所有 Bootstrap J*aScript 插件及其依赖（如 Popper.js），是推荐的引入方式。如果只引入 bootstrap.min.js，可能需要单独引入 Popper.js。
2. CDN 链接更新： 确保您使用的 Bootstrap CSS 和 JS 的 CDN 链接是针对 Bootstrap 5 版本的。示例中已更新为 bootstrap@5.3.0。
3. 其他组件： 除了导航栏，其他使用 data-toggle 和 data-target 的组件，如模态框（Modal）、折叠面板（Collapse）、选项卡（Tab）等，也需要进行类似的 data-bs-* 属性更新。
4. 官方文档： 在进行版本迁移时，始终建议查阅 Bootstrap 官方文档的迁移指南，以获取最全面和最新的变动信息。

总结

Bootstrap 5 对数据属性命名空间的调整是其架构演进的一部分，旨在提升兼容性和可维护性。对于导航栏折叠功能失效的问题，核心在于将 data-toggle 和 data-target 更新为 data-bs-toggle 和 data-bs-target。通过理解并应用这些变化，您可以确保您的 Bootstrap 5 项目中的交互组件能够正常工作，从而顺利完成从旧版本到新版本的升级。

以上就是解决 Bootstrap 5 导航栏折叠失效问题：数据属性迁移指南的详细内容，更多请关注其它相关文章！

# 的是  # 薛城网站网络推广  # seo内部外部哪个重要  # 什么网站直接推广售卖  # 电子烟市场营销推广方案  # 尉氏网络营销推广  # 新视窗网站推广怎么样  # 网站建设与设计报告  # seo单页排名技术  # SEO辅助站  # 营销推广的近义词  # 只需  # 模态  # 与其他  # 文档  # 是一个  # css  # 确保您  # 包含了  # 这一  # 您的  # .  # cdn  # ai  # npm  # bootstrap  # 前端  # js  # html  # jquery  # java  # javascript 

相关栏目： 【 Google疑问12 】 【 Facebook疑问10 】 【 优化推广96088 】 【 技术知识133117 】 【 IDC资讯59369 】 【 网络运营7196 】 【 IT资讯61894 】

相关推荐： C++ static关键字作用_C++静态成员变量与静态函数  什么是Satis，如何用它搭建一个私有的composer仓库？  263企业邮箱如何设置邮件转发功能  PDF文件去水印平台入口 PDF水印删除网址  汽水音乐车机版 汽水音乐车机版官方入口  byrutor直接访问入口 byrutor官方游戏库  CSS绝对定位与溢出控制：实现背景元素局部显示不触发滚动条  苹果手机聊天记录删除了如何恢复  PSD转AI文件的简单方法  苹果17 Pro如何启用分屏浏览_iPhone 17 Pro分屏浏览设置步骤  管理打开的编辑器：固定、分组和关闭技巧  优化 React onClick 事件处理：函数引用与箭头函数的对比  FullCalendar自定义按钮样式定制指南  外卖小程序对接第三方配送  漫蛙官网(首页入口)_漫蛙漫画稳定访问教程分享  豆包AI怎样为教育场景定制答疑逻辑_为教育场景定制豆包AI答疑逻辑方案【方案】  《律学法考》查看学习数据方法  QQ阅读小说搜索入口地址_QQ阅读小说搜索入口地址搜索在线阅读  mysql归档数据怎么导出为csv_mysql归档数据导出为csv文件的方法  《幻兽帕鲁》手游帕鲁捕捉技巧分享  Go语言反射机制：如何访问被嵌入结构体遮蔽的方法  CodeIgniter 3 连接 SQL Server：正确获取查询结果的教程  Sublime怎么自动添加CSS前缀_Sublime安装Autoprefixer插件  微博网页版访问入口 微博网页版网页端使用指南  为什么XML解析器对大小写敏感？ 理解XML规范中的大小写规则与最佳实践  J*aScript包管理器_Npm与Yarn对比  奥克斯空调不制热啥毛病_奥克斯空调不制热原因分析及解决技巧  Lar*el怎么实现全文搜索_Lar*el Scout集成Algolia教程  CodeIgniter 3 中基于 MySQL 数据高效生成动态图表教程  《梦想世界：长风问剑录》药师一图流分享  《360浏览器》自动保存账号密码设置方法  Golang如何使用gRPC拦截器实现日志收集_Golang gRPC拦截器日志收集实践  处理含命名空间的XML文件 Power Query中的高级技巧  《绝区零》2.3前瞻|直播|内容介绍  Go App Engine 项目结构与包管理深度指南  《三国：谋定天下》平民全阶段通用阵容  iPhone 13 Pro Max如何设置桌面小组件_iPhone 13 Pro Max小组件添加指南  菜鸟驿站的取件码忘了怎么办 手机快速查询指南  《大学搜题酱》官网地址登录  《edge浏览器》关闭翻译功能方法  如何在CSS中清除浮动解决背景颜色不包裹内容问题_clear after技巧  使用document.execCommand实现Web文本编辑器加粗/取消加粗  J*a列表元素格式化输出教程  《sketchbook》选中部分图案移动方法  花生壳内网映射新方案  苹果官网国补入口在哪  批改网官网首页登录 批改网学生用户登录入口  《procreate》绘制渐变效果教程  实现二叉树的层序插入：基于树大小的路径导航  《崩坏：星穹铁道》3.6版本异相仲裁打法及配队推荐 

 2025-12-07