BOOTSTRA.386 实战:打造复古 DOS 风格的 Bootstrap 5.3 Navbar 导航栏

原创2026-10-16 08:54:581,633 阅读
文章标签:前端UI组件

BOOTSTRA.386 实战:打造复古 DOS 风格的 Bootstrap 5.3 Navbar 导航栏

本文以 BOOTSTRA.386 仓库中 v5.3.1 版本文档 navbar.md 为核心骨架,完整讲解 Bootstrap 5.3 Navbar 组件的原理、支持内容、配色方案、响应式折叠行为与底层 CSS/Sass 实现,并结合本仓库 v5.3.1/scss/ 与 v5.3.1/js/src/ 的真实源码进行印证。读完本文,你将能够在复古 386 风格主题下独立搭建品牌区、导航菜单、搜索表单、下拉菜单与 offcanvas 抽屉,并理解 navbar-expand-* 断点折叠、data-bs-theme 主题化与 CSS 变量定制机制,做到"既能写、又懂原理"。

一、Navbar 工作原理:先理解四个前提

在动手写代码之前,需要先明确 Bootstrap 5.3 Navbar 的几个核心约束(这些结论直接来自文档原文,并可在 v5.3.1/scss/_navbar.scss 的源码中得到印证):

  1. 必须成对出现:Navbar 需要外层 .navbar 包装元素,并搭配 .navbar-expand{-sm|-md|-lg|-xl|-xxl} 中的一个断点类,用于控制响应式折叠行为;同时还需使用颜色方案类(如 data-bs-theme)来确定外观。
  2. 默认是流式(fluid)布局:Navbar 及其内容默认占满容器宽度,可以通过容器(Containers)来限制水平宽度。
  3. 对齐靠工具类:Navbar 内部的间距与对齐,主要借助 spacing 与 flex 工具类(如 me-auto、mb-2、d-flex)来完成,而不是内联样式。
  4. 折叠依赖 Collapse 插件:Navbar 的响应式折叠行为由 Bootstrap 的 Collapse JavaScript 插件驱动,对应源码为 v5.3.1/js/src/collapse.js。

除此之外,无障碍(Accessibility)是文档强调的硬性要求:

  • 尽量使用语义化 <nav> 元素;如果出于结构原因使用了 <div> 等通用元素,必须为每个 navbar 添加 role="navigation",以显式标识为辅助技术可识别的 landmark 区域。
  • 当前页/当前项必须通过 aria-current 标注:整页导航用 aria-current="page",一组内的当前项用 aria-current="true"。
  • 官方文档同时提醒(v5.3 新增的 prefers-reduced-motion 提示):折叠与展开动画应尊重用户的「减少动态效果」系统偏好,Collapse 插件在实现中通过 show/shown/hide/hidden 事件与过渡回调来处理动画时序。

版本演进方面有一个重要变化(文档明确标注):

New in v5.2.0: Navbars can be themed with CSS variables that are scoped to the .navbar base class. .navbar-light has been deprecated and .navbar-dark has been rewritten to override CSS variables instead of adding additional styles.

也就是说,从 v5.2 开始 Navbar 的主题化全面转向 CSS 变量(Custom Properties),.navbar-light 已废弃(源码中仅保留 @include deprecate(...) 提示,见 v5.3.1/scss/_navbar.scss#L266-L268),.navbar-dark 则被重写为"覆盖 CSS 变量"而非追加新样式。

二、支持的内容:七个内置子组件

Navbar 内置了对以下子组件的支持,按需选用即可:

子组件类 用途
.navbar-brand 公司、产品或项目名称
.navbar-nav 全高、轻量的导航(支持下拉菜单)
.navbar-toggler 配合 Collapse 插件使用的折叠按钮,也可配合其他导航切换行为
flex / spacing 工具类 用于任意表单控件与操作按钮的布局
.navbar-text 垂直居中的文本串
.collapse.navbar-collapse 按父级断点分组并隐藏 navbar 内容
.navbar-scroll(可选) 为展开的 navbar 内容设置 max-height 并启用滚动

下面是一个"全家福"示例:浅色主题、在 lg(大屏)断点自动折叠的完整响应式 Navbar。它同时用到了 bg-body-tertiary(背景工具类)与 me-auto、mb-2、mb-lg-0、me-2(间距工具类):

<nav class="navbar navbar-expand-lg bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarSupportedContent">
      <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Link</a>
        </li>
        <li class="nav-item dropdown">
          <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
            Dropdown
          </a>
          <ul class="dropdown-menu">
            <li><a class="dropdown-item" href="#">Action</a></li>
            <li><a class="dropdown-item" href="#">Another action</a></li>
            <li><hr class="dropdown-divider"></li>
            <li><a class="dropdown-item" href="#">Something else here</a></li>
          </ul>
        </li>
        <li class="nav-item">
          <a class="nav-link disabled" aria-disabled="true">Disabled</a>
        </li>
      </ul>
      <form class="d-flex" role="search">
        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
        <button class="btn btn-outline-success" type="submit">Search</button>
      </form>
    </div>
  </div>
</nav>

2.1 品牌区 .navbar-brand

.navbar-brand 可以应用到大多数元素上,但文档建议使用 <a> 锚点——因为某些元素可能需要额外的工具类或自定义样式才能获得正确的对齐。

纯文本品牌:既可作为链接,也可作为标题(<span> + mb-0 h1):

<!-- As a link -->
<nav class="navbar bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
  </div>
</nav>

<!-- As a heading -->
<nav class="navbar bg-body-tertiary">
  <div class="container-fluid">
    <span class="navbar-brand mb-0 h1">Navbar</span>
  </div>
</nav>

图片品牌:用 <img> 替换文本,示例中 width="30" height="24" 用于固定图片尺寸:

<nav class="navbar bg-body-tertiary">
  <div class="container">
    <a class="navbar-brand" href="#">
      <img src="logo.svg" alt="Bootstrap" width="30" height="24">
    </a>
  </div>
</nav>

图文并茂:注意图片上必须追加 .d-inline-block 与 .align-text-top,才能与文字基线正确对齐:

<nav class="navbar bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">
      <img src="logo.svg" alt="Logo" width="30" height="24" class="d-inline-block align-text-top">
      Bootstrap
    </a>
  </div>
</nav>

从源码看,.navbar-brand 的样式完全由 CSS 变量驱动(字号、内边距、外边距、颜色与悬停色),见 v5.3.1/scss/_navbar.scss#L66-L80:

.navbar-brand {
  padding-top: var(--#{$prefix}navbar-brand-padding-y);
  padding-bottom: var(--#{$prefix}navbar-brand-padding-y);
  margin-right: var(--#{$prefix}navbar-brand-margin-end);
  @include font-size(var(--#{$prefix}navbar-brand-font-size));
  color: var(--#{$prefix}navbar-brand-color);
  text-decoration: if($link-decoration == none, null, none);
  white-space: nowrap;

  &:hover,
  &:focus {
    color: var(--#{$prefix}navbar-brand-hover-color);
    text-decoration: if($link-hover-decoration == underline, none, null);
  }
}

2.2 导航 .navbar-nav

.navbar-nav 基于 .nav 选项体系,加上自己的修饰类,且需要配合 toggler 类才能获得正确的响应式样式。文档特别强调一个行为:

Navigation in navbars will also grow to occupy as much horizontal space as possible to keep your navbar contents securely aligned.

即导航链接会尽量占据可用水平空间。用 .active 类标记当前页,同时必须附加 aria-current 属性。

<nav class="navbar navbar-expand-lg bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav" aria-controls="navbarNav" aria-expanded="false" aria-label="Toggle navigation">
      <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" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Features</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Pricing</a>
        </li>
        <li class="nav-item">
          <a class="nav-link disabled" aria-disabled="true">Disabled</a>
        </li>
      </ul>
    </div>
  </div>
</nav>

因为导航完全基于类实现,所以可以完全放弃 <ul>/<li> 列表结构,直接使用 <div class="navbar-nav"> 包裹链接:

<nav class="navbar navbar-expand-lg bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNavAltMarkup" aria-controls="navbarNavAltMarkup" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarNavAltMarkup">
      <div class="navbar-nav">
        <a class="nav-link active" aria-current="page" href="#">Home</a>
        <a class="nav-link" href="#">Features</a>
        <a class="nav-link" href="#">Pricing</a>
        <a class="nav-link disabled" aria-disabled="true">Disabled</a>
      </div>
    </div>
  </div>
</nav>

Navbar 内同样可以嵌入下拉菜单。注意:下拉菜单需要包裹元素来定位,因此 .nav-item 与 .nav-link 必须使用分离且嵌套的元素:

<nav class="navbar navbar-expand-lg bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNavDropdown" aria-controls="navbarNavDropdown" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarNavDropdown">
      <ul class="navbar-nav">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Features</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Pricing</a>
        </li>
        <li class="nav-item dropdown">
          <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
            Dropdown link
          </a>
          <ul class="dropdown-menu">
            <li><a class="dropdown-item" href="#">Action</a></li>
            <li><a class="dropdown-item" href="#">Another action</a></li>
            <li><a class="dropdown-item" href="#">Something else here</a></li>
          </ul>
        </li>
      </ul>
    </div>
  </div>
</nav>

源码层面,.navbar-nav 默认是纵向 flex 布局(flex-direction: column),在小屏折叠状态下竖排展示;只有在命中 navbar-expand-* 断点后才会切换为横向行(flex-direction: row),并且 .dropdown-menu 会从 position: static 切换为 position: absolute(见 v5.3.1/scss/_navbar.scss#L87-L114 与 navbar-expand 循环部分)。.nav-link 的 .active/.show 状态色直接取 --bs-navbar-active-color 变量。

2.3 表单 Forms

Navbar 中可以放置各种表单控件与组件。最简单的是 d-flex 搜索表单:

<nav class="navbar bg-body-tertiary">
  <div class="container-fluid">
    <form class="d-flex" role="search">
      <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
      <button class="btn btn-outline-success" type="submit">Search</button>
    </form>
  </div>
</nav>

.navbar 的直接子元素使用 flex 布局,默认 justify-content: space-between(源码见 v5.3.1/scss/_navbar.scss#L30-L47:display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between)。因此品牌区与表单会自动分居两侧:

<nav class="navbar bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand">Navbar</a>
    <form class="d-flex" role="search">
      <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
      <button class="btn btn-outline-success" type="submit">Search</button>
    </form>
  </div>
</nav>

输入组(Input group)同样可用。如果整个 navbar 就是一个表单(或大部分是表单),可以直接用 <form> 作为容器,省掉一层 HTML:

<nav class="navbar bg-body-tertiary">
  <form class="container-fluid">
    <div class="input-group">
      <span class="input-group-text" id="basic-addon1">@</span>
      <input type="text" class="form-control" placeholder="Username" aria-label="Username" aria-describedby="basic-addon1">
    </div>
  </form>
</nav>

各类按钮也支持嵌套在表单中,同时这也是演示垂直对齐工具类的经典场景——不同尺寸的元素可以通过 align-items 系列工具类对齐:

<nav class="navbar bg-body-tertiary">
  <form class="container-fluid justify-content-start">
    <button class="btn btn-outline-success me-2" type="button">Main button</button>
    <button class="btn btn-sm btn-outline-secondary" type="button">Smaller button</button>
  </form>
</nav>

2.4 文本 .navbar-text

.navbar-text 用于放置垂直居中、水平有适当间距的文本串,它调整了垂直对齐与水平间距(源码见 v3.3.2/scss/_navbar.scss 同构实现,v5.3.1 中对应 [v5.3.1/scss/_navbar.scss#L121-L131):

<nav class="navbar bg-body-tertiary">
  <div class="container-fluid">
    <span class="navbar-text">
      Navbar text with an inline element
    </span>
  </div>
</nav>

也可以与品牌、导航混合使用——在折叠区内部使用 me-auto 将导航推到左侧、文本顶到右侧:

<nav class="navbar navbar-expand-lg bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar w/ text</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarText" aria-controls="navbarText" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarText">
      <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Features</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Pricing</a>
        </li>
      </ul>
      <span class="navbar-text">
        Navbar text with an inline element
      </span>
    </div>
  </div>
</nav>

三、颜色方案 Color schemes

v5.3 版本对 Navbar 主题化做了一次重要换代(文档中的 warning callout 明确说明):

New dark navbars in v5.3.0 — We've deprecated .navbar-dark in favor of the new data-bs-theme="dark". Add data-bs-theme="dark" to the .navbar to enable a component-specific color mode.

New in v5.2.0 — Navbar theming is now powered by CSS variables and .navbar-light has been deprecated. CSS variables are applied to .navbar, defaulting to the "light" appearance, and can be overridden with .navbar-dark.

也就是说:

  • 默认是"浅色 navbar",用于浅色背景;
  • 深色模式推荐使用 data-bs-theme="dark"(组件级颜色模式),不再依赖 .navbar-dark;
  • 再配合 .bg-* 背景工具类与额外工具类做进一步定制。

三个典型配色示例:

<!-- 深色主题 + 深色背景 -->
<nav class="navbar bg-dark border-bottom border-body" data-bs-theme="dark">
  <!-- Navbar content -->
</nav>

<!-- 深色主题 + primary 主色背景 -->
<nav class="navbar bg-primary" data-bs-theme="dark">
  <!-- Navbar content -->
</nav>

<!-- 浅色主题 + 自定义内联背景色 -->
<nav class="navbar" style="background-color: #e3f2fd;">
  <!-- Navbar content -->
</nav>

从源码可以清楚地看到"CSS 变量覆盖"的实现方式(v5.3.1/scss/_navbar.scss#L270-L282):

.navbar-dark,
.navbar[data-bs-theme="dark"] {
  // scss-docs-start navbar-dark-css-vars
  --#{$prefix}navbar-color: #{$navbar-dark-color};
  --#{$prefix}navbar-hover-color: #{$navbar-dark-hover-color};
  --#{$prefix}navbar-disabled-color: #{$navbar-dark-disabled-color};
  --#{$prefix}navbar-active-color: #{$navbar-dark-active-color};
  --#{$prefix}navbar-brand-color: #{$navbar-dark-brand-color};
  --#{$prefix}navbar-brand-hover-color: #{$navbar-dark-brand-hover-color};
  --#{$prefix}navbar-toggler-border-color: #{$navbar-dark-toggler-border-color};
  --#{$prefix}navbar-toggler-icon-bg: #{escape-svg($navbar-dark-toggler-icon-bg)};
  // scss-docs-end navbar-dark-css-vars
}

这里 data-bs-theme="dark" 与 .navbar-dark 走的是完全相同的选择器组,且没有追加任何新样式,只是重写了同一组 CSS 变量——这就是"变量主题化"与旧版"追加样式"的本质区别。同时,当全局启用深色模式($enable-dark-mode)时,源码还会在 color-mode(dark) 作用域内自动替换 toggler 图标背景(v5.3.1/scss/_navbar.scss#L284-L289)。

四、容器 Containers

虽然并非必需,但可以:

  • 在页面层用 .container 包裹整个 navbar 以居中——注意内部仍需再放一个 container;
  • 或者在 .navbar 内部加 container,只让固定或静态顶部 navbar 的内容居中。

外层容器示例:

<div class="container">
  <nav class="navbar navbar-expand-lg bg-body-tertiary">
    <div class="container-fluid">
      <a class="navbar-brand" href="#">Navbar</a>
    </div>
  </nav>
</div>

内层使用任意响应式容器(.container-sm/-md/-lg/-xl/-xxl、.container-fluid)可以控制内容宽度。例如 container-md 让内容在 md 及以上断点受限、更窄视口下占满全宽:

<nav class="navbar navbar-expand-lg bg-body-tertiary">
  <div class="container-md">
    <a class="navbar-brand" href="#">Navbar</a>
  </div>
</nav>

源码对容器兼容的处理非常巧妙:在 v5.3.1/scss/_navbar.scss#L42-L58 中定义了一个 %container-flex-properties 占位符(display: flex; flex-wrap: inherit; align-items: center; justify-content: space-between),然后让 .navbar > .container、.navbar > .container-fluid 以及所有 .navbar > .container#{断点后缀}(通过 $container-max-widths map 遍历生成)都 @extend 它——因为 flex 属性不会继承,这样做是为了让 navbar 内部嵌套的容器元素保持与 .navbar 一致的 flex 行为。

五、位置 Placement

借助 position 工具类可以将 navbar 放置在非静态位置。文档给出四种经典形态:

  • fixed-top:固定到顶部;
  • fixed-bottom:固定到底部;
  • sticky-top:吸顶——随页面滚动,滚到顶部后停留;
  • sticky-bottom:吸底——随页面滚动,滚到底部后停留。
<nav class="navbar bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Default</a>
  </div>
</nav>

<nav class="navbar fixed-top bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Fixed top</a>
  </div>
</nav>

<nav class="navbar fixed-bottom bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Fixed bottom</a>
  </div>
</nav>

<nav class="navbar sticky-top bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Sticky top</a>
  </div>
</nav>

<nav class="navbar sticky-bottom bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Sticky bottom</a>
  </div>
</nav>

文档特别提醒一个坑:fixed navbar 使用 position: fixed,会脱离 DOM 正常文档流,可能遮挡正文内容,通常需要自定义 CSS(例如给 <body> 增加 padding-top)来避免元素重叠。仓库自带的示例页面可作为参考实现:navbar-static 示例(静态顶栏)、navbar-fixed 示例(固定顶栏)与 navbar-bottom 示例(底部导航),carousel 示例 与 dashboard 示例 中也能看到 fixed-top/sticky-top 的真实组合用法。

六、滚动 Scrolling

给 .navbar-nav(或 navbar 的其他子组件)添加 .navbar-nav-scroll 类,可在折叠状态下让可切换内容内部垂直滚动。

  • 默认滚动阈值是 75vh(视口高度的 75%);
  • 可以通过局部 CSS 自定义属性 --bs-scroll-height 覆盖;
  • 在大视口、navbar 展开时,内容表现与普通 navbar 一致(不滚动)。

需要注意 overflow 的副作用:启用 overflow-y: auto(滚动所必需)时,overflow-x 会等效为 auto,可能裁切部分横向内容。

带自定义滚动高度的示例:

<nav class="navbar navbar-expand-lg bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar scroll</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarScroll" aria-controls="navbarScroll" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarScroll">
      <ul class="navbar-nav me-auto my-2 my-lg-0 navbar-nav-scroll" style="--bs-scroll-height: 100px;">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Link</a>
        </li>
        <li class="nav-item dropdown">
          <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
            Link
          </a>
          <ul class="dropdown-menu">
            <li><a class="dropdown-item" href="#">Action</a></li>
            <li><a class="dropdown-item" href="#">Another action</a></li>
            <li><hr class="dropdown-divider"></li>
            <li><a class="dropdown-item" href="#">Something else here</a></li>
          </ul>
        </li>
        <li class="nav-item">
          <a class="nav-link disabled" aria-disabled="true">Link</a>
        </li>
      </ul>
      <form class="d-flex" role="search">
        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
        <button class="btn btn-outline-success" type="submit">Search</button>
      </form>
    </div>
  </div>
</nav>

其底层样式非常简洁(v5.3.1/scss/_navbar.scss#L185-L188):

.navbar-nav-scroll {
  max-height: var(--#{$prefix}scroll-height, 75vh);
  overflow-y: auto;
}

在 navbar-expand-* 命中大屏断点后,.navbar-nav-scroll 会被重置为 overflow: visible(v5.3.1/scss/_navbar.scss#L217-L219),即"折叠时才滚动、展开时恢复默认"。

七、响应式行为 Responsive behaviors

Navbar 借助 .navbar-toggler、.navbar-collapse 与 .navbar-expand{-sm|-md|-lg|-xl|-xxl} 决定内容在哪个断点折叠到按钮之后;再配合其他工具类,可以精确控制某个元素的显隐时机。

两个极端形态:

  • 从不折叠:加 .navbar-expand(不带断点后缀);
  • 始终折叠:不加任何 .navbar-expand 类。

7.1 Toggler 按钮的三种布局

toggler 默认左对齐;但若它紧跟 .navbar-brand 之类的兄弟元素,会自动贴到最右侧;调换标记顺序即可反转 toggler 的位置。

最小断点下不显示品牌,toggler 在最左:

<nav class="navbar navbar-expand-lg bg-body-tertiary">
  <div class="container-fluid">
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarTogglerDemo01" aria-controls="navbarTogglerDemo01" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarTogglerDemo01">
      <a class="navbar-brand" href="#">Hidden brand</a>
      <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Link</a>
        </li>
        <li class="nav-item">
          <a class="nav-link disabled" aria-disabled="true">Disabled</a>
        </li>
      </ul>
      <form class="d-flex" role="search">
        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
        <button class="btn btn-outline-success" type="submit">Search</button>
      </form>
    </div>
  </div>
</nav>

品牌在左、toggler 在右(最常见形态):

<nav class="navbar navbar-expand-lg bg-body-tertiary">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarTogglerDemo02" aria-controls="navbarTogglerDemo02" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="collapse navbar-collapse" id="navbarTogglerDemo02">
      <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Link</a>
        </li>
        <li class="nav-item">
          <a class="nav-link disabled" aria-disabled="true">Disabled</a>
        </li>
      </ul>
      <form class="d-flex" role="search">
        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
        <button class="btn btn-outline-success" type="submit">Search</button>
      </form>
    </div>
  </div>
</nav>

toggler 在左、品牌在右(反转标记顺序):

<nav class="navbar navbar-expand-lg bg-body-tertiary">
  <div class="container-fluid">
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarTogglerDemo03" aria-controls="navbarTogglerDemo03" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <a class="navbar-brand" href="#">Navbar</a>
    <div class="collapse navbar-collapse" id="navbarTogglerDemo03">
      <ul class="navbar-nav me-auto mb-2 mb-lg-0">
        <li class="nav-item">
          <a class="nav-link active" aria-current="page" href="#">Home</a>
        </li>
        <li class="nav-item">
          <a class="nav-link" href="#">Link</a>
        </li>
        <li class="nav-item">
          <a class="nav-link disabled" aria-disabled="true">Disabled</a>
        </li>
      </ul>
      <form class="d-flex" role="search">
        <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
        <button class="btn btn-outline-success" type="submit">Search</button>
      </form>
    </div>
  </div>
</nav>

7.2 外部内容 External content

有时候希望用 Collapse 插件触发结构上位于 .navbar 之外的容器。由于插件基于 id 与 data-bs-target 的匹配工作,这很容易实现:

<div class="collapse" id="navbarToggleExternalContent" data-bs-theme="dark">
  <div class="bg-dark p-4">
    <h5 class="text-body-emphasis h4">Collapsed content</h5>
    <span class="text-body-secondary">Toggleable via the navbar brand.</span>
  </div>
</div>
<nav class="navbar navbar-dark bg-dark">
  <div class="container-fluid">
    <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarToggleExternalContent" aria-controls="navbarToggleExternalContent" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
  </div>
</nav>

文档对此给出两条重要的可访问性建议:

  1. 补充 JavaScript:内容打开时,将焦点程序化地移动到该容器;否则键盘用户与辅助技术用户可能很难发现新展开的内容——尤其当容器在文档结构中位于 toggler 之前时。
  2. 保证 aria-controls:toggler 上的 aria-controls 必须指向内容容器的 id,理论上允许辅助技术用户直接从 toggler 跳转到它控制的容器——但文档同时指出目前该特性在各类辅助技术中的支持"quite patchy"(相当参差不齐)。

7.3 Offcanvas 抽屉

借助 offcanvas 组件,可以把"展开/折叠式 navbar"改造成侧滑抽屉式导航。做法是同时扩展 offcanvas 默认样式,并复用 .navbar-expand-* 类,构造出动态灵活的导航侧边栏。

始终折叠的 offcanvas navbar:省略 .navbar-expand-* 类,让它在所有断点都以抽屉形式存在:

<nav class="navbar bg-body-tertiary fixed-top">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Offcanvas navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbar" aria-controls="offcanvasNavbar" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="offcanvas offcanvas-end" tabindex="-1" id="offcanvasNavbar" aria-labelledby="offcanvasNavbarLabel">
      <div class="offcanvas-header">
        <h5 class="offcanvas-title" id="offcanvasNavbarLabel">Offcanvas</h5>
        <button type="button" class="btn-close" data-bs-dismiss="offcanvas" aria-label="Close"></button>
      </div>
      <div class="offcanvas-body">
        <ul class="navbar-nav justify-content-end flex-grow-1 pe-3">
          <li class="nav-item">
            <a class="nav-link active" aria-current="page" href="#">Home</a>
          </li>
          <li class="nav-item">
            <a class="nav-link" href="#">Link</a>
          </li>
          <li class="nav-item dropdown">
            <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
              Dropdown
            </a>
            <ul class="dropdown-menu">
              <li><a class="dropdown-item" href="#">Action</a></li>
              <li><a class="dropdown-item" href="#">Another action</a></li>
              <li>
                <hr class="dropdown-divider">
              </li>
              <li><a class="dropdown-item" href="#">Something else here</a></li>
            </ul>
          </li>
        </ul>
        <form class="d-flex mt-3" role="search">
          <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
          <button class="btn btn-outline-success" type="submit">Search</button>
        </form>
      </div>
    </div>
  </div>
</nav>

在指定断点(如 lg)恢复为普通 navbar 的 offcanvas:加上 .navbar-expand-lg 即可,大屏下 offcanvas 会被展开成常规导航:

<nav class="navbar navbar-expand-lg bg-body-tertiary fixed-top">
  <a class="navbar-brand" href="#">Offcanvas navbar</a>
  <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#navbarOffcanvasLg" aria-controls="navbarOffcanvasLg" aria-label="Toggle navigation">
    <span class="navbar-toggler-icon"></span>
  </button>
  <div class="offcanvas offcanvas-end" tabindex="-1" id="navbarOffcanvasLg" aria-labelledby="navbarOffcanvasLgLabel">
    ...
  </div>
</nav>

深色 offcanvas 的配套建议:在深色 navbar 中使用 offcanvas 时,需要给 offcanvas 内容也配上深色背景,否则文字可能难以辨认。文档给出的组合是:.navbar 上加 .navbar-dark 与 .bg-dark,.offcanvas 上加 .text-bg-dark,.dropdown-menu 上加 .dropdown-menu-dark,.btn-close 上加 .btn-close-white:

<nav class="navbar navbar-dark bg-dark fixed-top">
  <div class="container-fluid">
    <a class="navbar-brand" href="#">Offcanvas dark navbar</a>
    <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasDarkNavbar" aria-controls="offcanvasDarkNavbar" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
    <div class="offcanvas offcanvas-end text-bg-dark" tabindex="-1" id="offcanvasDarkNavbar" aria-labelledby="offcanvasDarkNavbarLabel">
      <div class="offcanvas-header">
        <h5 class="offcanvas-title" id="offcanvasDarkNavbarLabel">Dark offcanvas</h5>
        <button type="button" class="btn-close btn-close-white" data-bs-dismiss="offcanvas" aria-label="Close"></button>
      </div>
      <div class="offcanvas-body">
        <ul class="navbar-nav justify-content-end flex-grow-1 pe-3">
          <li class="nav-item">
            <a class="nav-link active" aria-current="page" href="#">Home</a>
          </li>
          <li class="nav-item">
            <a class="nav-link" href="#">Link</a>
          </li>
          <li class="nav-item dropdown">
            <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
              Dropdown
            </a>
            <ul class="dropdown-menu dropdown-menu-dark">
              <li><a class="dropdown-item" href="#">Action</a></li>
              <li><a class="dropdown-item" href="#">Another action</a></li>
              <li>
                <hr class="dropdown-divider">
              </li>
              <li><a class="dropdown-item" href="#">Something else here</a></li>
            </ul>
          </li>
        </ul>
        <form class="d-flex mt-3" role="search">
          <input class="form-control me-2" type="search" placeholder="Search" aria-label="Search">
          <button class="btn btn-success" type="submit">Search</button>
        </form>
      </div>
    </div>
  </div>
</nav>

在源码中,offcanvas 与 navbar-expand 的配合逻辑体现在 v5.3.1/scss/_navbar.scss#L230-L255:大屏断点命中后,offcanvas 被重置为 position: static、z-index: auto、width/height: auto、visibility: visible、background-color: transparent、transform: none,并隐藏 .offcanvas-header、将 .offcanvas-body 变成 flex 布局——这正是"抽屉在大屏自动还原为普通导航"的实现原理。

八、折叠背后的引擎:Collapse 插件源码解析

Navbar 的折叠、外部内容切换都依赖 v5.3.1/js/src/collapse.js(约 297 行)。几个值得注意的实现细节:

  • 触发机制:构造函数会通过 SelectorEngine.find('<a href="https://link.gitcode.com/i/0decc7357508c20b853a2d2a366ebf72" target="_blank">data-bs-toggle="collapse"]') 收集所有触发按钮,再用 getSelectorFromElement 读取 data-bs-target,与当前元素匹配后存入 _triggerArray([v5.3.1/js/src/collapse.js#L66-L76)。
  • 展开 show():先触发 show 事件(可被 preventDefault 取消),移除 collapse 类、添加 collapsing 类,把高度/宽度动画到 scrollHeight/scrollWidth,动画完成回调中再切回 collapse + show 并触发 shown 事件(v5.3.1/js/src/collapse.js#L111-L164)。
  • 收起 hide():先测量当前实际尺寸作为起始值,再切到 collapsing 并归零,最后恢复 collapse 并触发 hidden(v5.3.1/js/src/collapse.js#L166-L205)。
  • 横/纵向折叠:_getDimension() 根据是否含 collapse-horizontal 决定动画 width 还是 height(v5.3.1/js/src/collapse.js#L218-L220)。

因此文档中"Responsive behavior depends on our Collapse JavaScript plugin"这句话在源码层面是完全成立的——折叠本质上是 Collapse 插件在 .navbar-collapse 元素上执行的高度动画。

九、CSS 与 Sass 深度解析

9.1 CSS 变量(v5.2.0+ 新增)

Navbar 现在使用 .navbar 上的局部 CSS 变量进行实时定制。这些变量的取值由 Sass 设定,因此 Sass 定制仍然完全支持。.navbar 基类上的完整变量集见 v5.3.1/scss/_navbar.scss#L6-L28:

.navbar {
  --#{$prefix}navbar-padding-x: ...;
  --#{$prefix}navbar-padding-y: ...;
  --#{$prefix}navbar-color: ...;
  --#{$prefix}navbar-hover-color: ...;
  --#{$prefix}navbar-disabled-color: ...;
  --#{$prefix}navbar-active-color: ...;
  --#{$prefix}navbar-brand-padding-y: ...;
  --#{$prefix}navbar-brand-margin-end: ...;
  --#{$prefix}navbar-brand-font-size: ...;
  --#{$prefix}navbar-brand-color: ...;
  --#{$prefix}navbar-brand-hover-color: ...;
  --#{$prefix}navbar-nav-link-padding-x: ...;
  --#{$prefix}navbar-toggler-padding-y: ...;
  --#{$prefix}navbar-toggler-padding-x: ...;
  --#{$prefix}navbar-toggler-font-size: ...;
  --#{$prefix}navbar-toggler-icon-bg: ...;
  --#{$prefix}navbar-toggler-border-color: ...;
  --#{$prefix}navbar-toggler-border-radius: ...;
  --#{$prefix}navbar-toggler-focus-width: ...;
  --#{$prefix}navbar-toggler-transition: ...;
}

.navbar-nav 上还有一组补充变量(v5.3.1/scss/_navbar.scss#L87-L96),它把 nav-link 的颜色系联到 navbar 颜色:

.navbar-nav {
  --#{$prefix}nav-link-padding-x: 0;
  --#{$prefix}nav-link-padding-y: #{$nav-link-padding-y};
  --#{$prefix}nav-link-font-size: ...;   // 通过 rfs() 生成
  --#{$prefix}nav-link-font-weight: ...;
  --#{$prefix}nav-link-color: var(--#{$prefix}navbar-color);
  --#{$prefix}nav-link-hover-color: var(--#{$prefix}navbar-hover-color);
  --#{$prefix}nav-link-disabled-color: var(--#{$prefix}navbar-disabled-color);
}

而 data-bs-theme="dark" / .navbar-dark 的定制,正是"只覆盖变量、不重复选择器"的范例(见上文颜色方案一节的源码)。

9.2 Sass 变量

所有 navbar 通用变量定义在 v5.3.1/scss/_variables.scss#L1278-L1305:

变量 默认值 说明
$navbar-padding-y 0(spacer * .5 被注释) 垂直内边距
$navbar-padding-x null 水平内边距(null 时 CSS 变量回退为 0)
$navbar-nav-link-padding-x $_font-size-base-px 展开态导航链接水平内边距
$navbar-brand-font-size $font-size-lg 品牌字号
$navbar-brand-height $navbar-brand-font-size * $line-height-base 用于计算品牌高度
$navbar-brand-padding-y 0 品牌垂直内边距
$navbar-brand-margin-end $_font-size-base-px 品牌右侧外边距
$navbar-toggler-padding-y/x 0 toggler 内边距
$navbar-toggler-font-size $font-size-lg toggler 字号
$navbar-toggler-border-radius $btn-border-radius toggler 圆角
$navbar-toggler-focus-width $btn-focus-width toggler 焦点环宽度
$navbar-toggler-transition box-shadow .15s ease-in-out toggler 过渡
$navbar-light-color rgba(emphasis-color-rgb, .65) 浅色主题链接色
$navbar-light-hover-color rgba(emphasis-color-rgb, .8) 悬停色
$navbar-light-active-color rgba(emphasis-color-rgb, 1) 激活色
$navbar-light-disabled-color rgba(emphasis-color-rgb, .3) 禁用色
$navbar-light-icon-color rgba($body-color, .75) toggler 图标色
$navbar-light-toggler-icon-bg 内联 SVG(三横线) 浅色主题 toggler 图标
$navbar-light-toggler-border-color rgba(emphasis-color-rgb, .15) 浅色主题 toggler 边框
$navbar-light-brand-color / -hover-color 均取 $navbar-light-active-color 品牌色

深色主题专用变量(v5.3.1/scss/_variables.scss#L1308-L1317):

变量 默认值
$navbar-dark-color rgba($white, .55)
$navbar-dark-hover-color rgba($white, .75)
$navbar-dark-active-color $white
$navbar-dark-disabled-color rgba($white, .25)
$navbar-dark-icon-color $navbar-dark-color
$navbar-dark-toggler-icon-bg 内联 SVG(白色三横线)
$navbar-dark-toggler-border-color rgba($white, .1)
$navbar-dark-brand-color / -hover-color 均取 $navbar-dark-active-color

注意 toggler-icon-bg 默认值是内联 data URI SVG(三个圆角 stroke 横线,stroke-linecap="round" stroke-miterlimit="10" stroke-width="2"),并通过 escape-svg() 转义后注入 CSS 变量——这意味着想要自定义汉堡图标,只需覆盖 --bs-navbar-toggler-icon-bg 即可。

9.3 Sass 循环生成响应式类

.navbar-expand{-sm|-md|-lg|-xl|-xxl} 这些响应式折叠类并非手写,而是通过 $grid-breakpoints map 循环生成的(v5.3.1/scss/_navbar.scss#L190-L260):

.navbar-expand {
  @each $breakpoint in map-keys($grid-breakpoints) {
    $next: breakpoint-next($breakpoint, $grid-breakpoints);
    $infix: breakpoint-infix($next, $grid-breakpoints);

    &#{$infix} {
      @include media-breakpoint-up($next) {
        flex-wrap: nowrap;
        justify-content: flex-start;

        .navbar-nav {
          flex-direction: row;

          .dropdown-menu {
            position: absolute;
          }

          .nav-link {
            padding-right: var(--#{$prefix}navbar-nav-link-padding-x);
            padding-left: var(--#{$prefix}navbar-nav-link-padding-x);
          }
        }

        .navbar-nav-scroll {
          overflow: visible;
        }

        .navbar-collapse {
          display: flex !important;
          flex-basis: auto;
        }

        .navbar-toggler {
          display: none;
        }

        .offcanvas { /* 还原为静态内联导航 */ }
      }
    }
  }
}

这解释了前面所有行为的内在机制:命中断点后,.navbar 变为 nowrap 且 justify-content: flex-start,.navbar-nav 变为横向、.dropdown-menu 变为绝对定位、.navbar-collapse 强制 display: flex、.navbar-toggler 隐藏、.navbar-nav-scroll 恢复可见溢出、offcanvas 还原为普通导航。折叠/展开完全由这一套媒体查询驱动的规则决定。

十、在 BOOTSTRA.386 复古主题中的实践要点

BOOTSTRA.386 是一个"让网页看起来像 1980 年代 DOS 界面"的 Bootstrap v2/3/4/5 主题(见仓库根目录 README.md),v5.3.1/ 目录本身就是一个针对 Bootstrap 5.3.1 的 fork,包含完整的 scss/ 源码、js/src 组件源码与 site/ 文档站。

在 386 复古语境下使用 Navbar,需要注意以下几点:

  1. 主题化的 DOS 质感来自全局基底:复古观感主要由 v5.3.1/scss/_dos.scss 这类全局文件贡献——例如像素风滚动条(::-webkit-scrollbar 系列)、DOS 光标(.bootstra-cursor,mix-blend-mode: difference 的 #cbd448 方块)以及隐藏原生光标的 body.bootstra-enable-cursor 规则。Navbar 本身在 386 主题中仍然遵循 Bootstrap 5.3 的组件规范,无需特殊类名即可与全局复古风格融合。
  2. 配色方案优先走 data-bs-theme:由于 v5.3 已弃用 .navbar-dark,复古主题下做深色导航条应使用 <nav class="navbar bg-dark" data-bs-theme="dark">,与源码中 data-bs-theme="dark" 与 .navbar-dark 共享同一组 CSS 变量覆盖逻辑(v5.3.1/scss/_navbar.scss#L270-L282)。
  3. 折叠行为不依赖主题:无论复古外观如何,.navbar-expand-lg 折叠、.navbar-nav-scroll 滚动、offcanvas 抽屉等行为均由 Collapse 插件与 navbar-expand 循环(v5.3.1/scss/_navbar.scss#L190-L260)驱动,可直接套用本文全部示例。
  4. 构建与定制入口:若要深度定制 386 主题下的 navbar,入口是 v5.3.1/scss/_navbar.scss 与 v5.3.1/scss/_variables.scss 中的 $navbar-* 系列变量;仓库根目录 README.md 说明了 v2/v3/v4/v5 各版本均为对应 Bootstrap 官方 tagged release 的 fork,文档站的组件示例(如 navbar-static、dashboard)也直接复用了本文讲解的 navbar 结构。

总结

Bootstrap 5.3 的 Navbar 是一个"结构约定 + 工具类 + Collapse 插件 + CSS 变量主题化"四层协作的组件:.navbar 负责 flex 基础布局,.navbar-expand-* 通过 Sass 循环生成断点折叠规则,.navbar-toggler 与 .navbar-collapse 依赖 collapse.js 完成高度动画,data-bs-theme="dark" 与 .navbar-dark 则通过覆盖 scss/_navbar.scss 中同一组 CSS 变量实现深浅主题切换。在 BOOTSTRA.386 复古主题中,你只需要按本文的标记结构组织品牌、导航、表单与文本,再套用 bg-dark/data-bs-theme 等组合,即可获得既符合无障碍规范、又带有 1980 年代 DOS 质感的响应式导航栏。

登录后查看全文
BOOTSTRA.386