本文详解 Bootstrap 5 中 Tabs 组件的使用规范，重点说明 data-toggle → data-bs-toggle 的属性变更、必需的 JavaScript 加载方式（需引入 bootstrap.bundle.min.js），以及 .tab-pane 类名中新增的 show 类作用。
本文详解 bootstrap 5 中 tabs 组件的使用规范，重点说明 `data-toggle` → `data-bs-toggle` 的属性变更、必需的 javascript 加载方式（需引入 `bootstrap.bundle.min.js`），以及 `.tab-pane` 类名中新增的 `show` 类作用。
Bootstrap 5 对组件的 JavaScript 行为和数据属性进行了标准化重构，其中 Tabs 是典型需要适配的组件之一。与 Bootstrap 4 相比，最核心的变更包括三方面：*数据属性前缀统一为 `data-bs-**、**必须加载 Bootstrap 官方 JS（推荐 bundle 版本）**、以及 **.tab-pane的显隐逻辑依赖fade show active组合类**（show` 不再可选，而是激活态的必要类）。
以下是一个完整、可直接运行的 Bootstrap 5 Tabs 示例：
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- Bootstrap 5 CSS -->
<link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/css/bootstrap.min.css" rel="stylesheet">
<!-- Bootstrap 5 JS（含 Popper，必需） -->
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/js/bootstrap.bundle.min.js"></script>
<title>Bootstrap 5 Tabs</title>
</head>
<body>
<div class="container mt-4">
<h3>Bootstrap 5 Tabs</h3>
<!-- 导航项：注意 data-bs-toggle 而非 data-toggle -->
<ul class="nav nav-tabs" role="tablist">
<li class="nav-item" role="presentation">
<a class="nav-link active" data-bs-toggle="tab" href="#home" role="tab" aria-controls="home" aria-selected="true">Home</a>
</li>
<li class="nav-item" role="presentation">
<a class="nav-link" data-bs-toggle="tab" href="#help" role="tab" aria-controls="help" aria-selected="false">Help</a>
</li>
</ul>
<!-- 内容区：每个 .tab-pane 必须有唯一 id，且初始激活项需同时含 fade、show、active -->
<div class="tab-content mt-3">
<div class="tab-pane fade show active" id="home" role="tabpanel">
<h4>Home Content</h4>
<p>This is the active tab panel. Note: <code>show</code> class is now required for visible state.</p>
</div>
<div class="tab-pane fade" id="help" role="tabpanel">
<h4>Help Content</h4>
<p>This tab will be shown only when clicked — thanks to Bootstrap’s built-in JS handlers.</p>
</div>
</div>
</div>
</body>
</html>✅ 关键注意事项：
- data-bs-toggle="tab" 是强制要求：Bootstrap 5 移除了对 jQuery 的依赖，所有交互式组件均通过 data-bs-* 属性触发原生 JS 行为；保留 data-toggle 将导致切换失效。
- 必须引入 bootstrap.bundle.min.js：它内置了 Popper 和 Bootstrap 所有 JS 插件（含 Tab），不可仅用 bootstrap.min.js（缺少 Popper，部分组件异常）。
- .tab-pane.fade.show.active 缺一不可：fade 提供淡入动画基础，show 是 Bootstrap 5 新增的“可见性开关”，active 标识当前激活状态；三者共同作用才能正确渲染初始内容。
- 语义化增强：建议为 <ul> 添加 role="tablist"，每个 <a> 添加 role="tab" 及 aria-* 属性，提升无障碍访问支持。
如需通过 JavaScript 手动控制 Tab 切换，可使用：
const triggerEl = document.querySelector('#myTab a[href="#profile"]');
bootstrap.Tab.getInstance(triggerEl).show(); // 激活指定 Tab掌握以上要点，即可平滑完成 Bootstrap 4 → 5 的 Tabs 迁移，并确保功能完整、语义合规、体验一致。
