本文旨在解决从 Bootstrap 4 迁移至 Bootstrap 5 后，导航栏（navbar）折叠功能失效的常见问题。核心原因在于 Bootstrap 5 对数据属性（`data-*` attributes）的命名规范进行了更新。通过将旧版 `data-toggle` 和 `data-target` 属性分别替换为 `data-bs-toggle` 和 `data-bs-target`，即可恢复导航栏的正常折叠行为。文章将提供详细的修改说明和示例代码，帮助开发者顺利解决此兼容性问题。
在前端开发中，Bootstrap 框架因其响应式设计和丰富的组件库而广受欢迎。然而，随着版本的迭代，API 和内部实现也会发生变化。从 Bootstrap 4 升级到 Bootstrap 5 时，开发者可能会遇到导航栏（Navbar）的折叠（collapse）功能失效的问题，即点击切换按钮后，导航菜单无法正常展开或收起。这通常是由于 Bootstrap 5 对 JavaScript 组件的数据属性（data attributes）引入了新的命名约定所致。
理解 Bootstrap 5 的数据属性变化
Bootstrap 5 为了避免与第三方库或自定义脚本的数据属性产生冲突，引入了 data-bs-* 前缀。这意味着所有由 Bootstrap JavaScript 组件控制的 HTML 元素，其相关的数据属性都需要从 data-* 更新为 data-bs-*。对于导航栏的折叠功能，主要涉及以下两个关键属性：
- data-toggle: 用于指定触发器（如按钮）所控制的组件类型，在 Bootstrap 4 中用于折叠组件。
- data-target: 用于指定折叠组件的目标元素 ID。
在 Bootstrap 5 中，它们需要相应地更新。
解决方案：更新数据属性
要解决 Bootstrap 5 导航栏折叠失效的问题，只需将 navbar-toggler 按钮上的 data-toggle 和 data-target 属性更改为 data-bs-toggle 和 data-bs-target。
具体修改如下：
- 将
data-toggle="collapse" 修改为 data-bs-toggle="collapse" - 将 data-target="#navbarNavAltMarkup" 修改为 data-bs-target="#navbarNavAltMarkup" (请根据您的实际目标 ID 进行调整)
data-toggle="collapse" 修改为 data-bs-toggle="collapse"示例代码
以下是一个修正后的 Bootstrap 5 导航栏示例，展示了正确的属性用法：
Navbar Test
代码解释：
- 请注意 button 元素中的 data-bs-toggle 和 data-bs-target 属性。
- Bootstrap 5 推荐使用 bootstrap.bundle.min.js，它包含了 Popper.js，因此通常无需单独引入 jQuery 和 Popper.js，除非您的项目有其他依赖。
- CSS 和 JS 的 CDN 链接已更新为 Bootstrap 5.3.0 的最新版本，以确保最佳兼容性。
注意事项
- JavaScript 引入： 确保您的项目中正确引入了 Bootstrap 5 的 JavaScript 文件，通常是 bootstrap.bundle.min.js。如果缺少或引入了错误的版本，导航栏的 JavaScript 功能将无法工作。
- CDN 链接： 确保您使用的 Bootstrap CSS 和 JS CDN 链接是针对 Bootstrap 5 的，而不是旧版本。
- 其他组件： 这种 data-bs-* 的命名约定不仅适用于导航栏折叠，也适用于 Bootstrap 5 的其他 JavaScript 驱动组件，例如模态框（Modal）、手风琴（Accordion）、下拉菜单（Dropdown）等。在升级过程中，请检查并相应更新所有相关的数据属性。
- 控制台错误： 如果在修改后问题仍然存在，请检查浏览器的开发者工具控制台，查找是否有 JavaScript 错误。这些错误通常能提供关于问题根源的线索。
- 清除缓存： 有时浏览器缓存可能会导致旧的脚本或样式被加载。在进行更改后，尝试清除浏览器缓存或使用无痕模式进行测试。
总结
从 Bootstrap 4 迁移到 Bootstrap 5 时，导航栏折叠功能失效是一个常见的兼容性问题。通过将 data-toggle 和 data-target 属性分别更新为 data-bs-toggle 和 data-bs-target，可以有效解决此问题。理解 Bootstrap 5 的 data-bs-* 命名约定对于顺利升级和使用其 JavaScript 驱动组件至关重要。遵循这些指导原则，您可以确保您的 Bootstrap 5 导航栏及其它交互式组件正常工作。
