在 GitHub 上查看

导航栏

Bootstrap 功能强大、响应式的导航栏标题（导航栏）的文档和示例。包括对品牌、导航、折叠插件等的支持。

工作原理

在开始使用导航栏之前，您需要了解以下内容

  • 导航栏需要一个包含 .navbar-expand{-sm|-md|-lg|-xl} 的包装 .navbar，用于响应式折叠和 配色方案 类。
  • 导航栏及其内容默认是流动的。使用 可选容器 来限制其水平宽度。
  • 使用我们的 间距 和 flex 实用程序类来控制导航栏内的间距和对齐方式。
  • 导航栏默认是响应式的，但您可以轻松修改它们以进行更改。响应式行为取决于我们的 Collapse JavaScript 插件。
  • 打印时，导航栏默认隐藏。通过将 .d-print 添加到 .navbar 来强制打印它们。请参阅 display 实用程序类。
  • 通过使用 <nav> 元素或（如果使用更通用的元素，例如 <div>）为每个导航栏添加 role="navigation" 来确保可访问性，以便明确将其标识为辅助技术用户的标志区域。
此组件的动画效果取决于 prefers-reduced-motion 媒体查询。请参阅 无障碍文档的减少运动部分。

受支持的内容

导航栏内置支持少数子组件。根据需要从以下内容中进行选择

  • .navbar-brand 用于您的公司、产品或项目名称。
  • .navbar-nav 用于全高且轻量级的导航（包括对下拉菜单的支持）。
  • .navbar-toggler 与我们的折叠插件和其他 导航切换 行为一起使用。
  • .form-inline 用于任何表单控件和操作。
  • .navbar-text 用于添加垂直居中的文本字符串。
  • .collapse.navbar-collapse 用于按父断点对导航栏内容进行分组和隐藏。

以下是一个响应式浅色主题导航栏中包含的所有子组件的示例，该导航栏会在 lg（大）断点处自动折叠。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
  <a class="navbar-brand" href="#">Navbar</a>
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-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 mr-auto">
      <li class="nav-item active">
        <a class="nav-link" href="#">Home <span class="sr-only">(current)</span></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-toggle="dropdown" aria-expanded="false">
          Dropdown
        </a>
        <div class="dropdown-menu">
          <a class="dropdown-item" href="#">Action</a>
          <a class="dropdown-item" href="#">Another action</a>
          <div class="dropdown-divider"></div>
          <a class="dropdown-item" href="#">Something else here</a>
        </div>
      </li>
      <li class="nav-item">
        <a class="nav-link disabled">Disabled</a>
      </li>
    </ul>
    <form class="form-inline my-2 my-lg-0">
      <input class="form-control mr-sm-2" type="search" placeholder="Search" aria-label="Search">
      <button class="btn btn-outline-success my-2 my-sm-0" type="submit">Search</button>
    </form>
  </div>
</nav>

此示例使用 颜色 (bg-light) 和 间距 (my-2、my-lg-0、mr-sm-0、my-sm-0) 实用程序类。

品牌

.navbar-brand 可应用于大多数元素，但锚点效果最佳，因为某些元素可能需要实用程序类或自定义样式。

<!-- As a link -->
<nav class="navbar navbar-light bg-light">
  <a class="navbar-brand" href="#">Navbar</a>
</nav>

<!-- As a heading -->
<nav class="navbar navbar-light bg-light">
  <span class="navbar-brand mb-0 h1">Navbar</span>
</nav>

将图像添加到 .navbar-brand 可能总是需要自定义样式或实用程序才能正确调整大小。以下是一些演示示例。

<!-- Just an image -->
<nav class="navbar navbar-light bg-light">
  <a class="navbar-brand" href="#">
    <img src="/docs/4.6/assets/brand/bootstrap-solid.svg" width="30" height="30" alt="">
  </a>
</nav>
<!-- Image and text -->
<nav class="navbar navbar-light bg-light">
  <a class="navbar-brand" href="#">
    <img src="/docs/4.6/assets/brand/bootstrap-solid.svg" width="30" height="30" class="d-inline-block align-top" alt="">
    Bootstrap
  </a>
</nav>

导航栏导航链接在我们的 .nav 选项的基础上构建，并使用自己的修饰符类，并且需要使用 切换器类 才能获得正确的响应式样式。导航栏中的导航也会尽可能地占据更多水平空间，以确保导航栏内容安全对齐。

活动状态——使用 .active——表示当前页面可以直接应用于 .nav-link 或其直接父级 .nav-item。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
  <a class="navbar-brand" href="#">Navbar</a>
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-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 active">
        <a class="nav-link" href="#">Home <span class="sr-only">(current)</span></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">Disabled</a>
      </li>
    </ul>
  </div>
</nav>

此外，由于我们为导航栏使用类，因此您可以完全避免基于列表的方法（如果您愿意）。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
  <a class="navbar-brand" href="#">Navbar</a>
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-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" href="#">Home <span class="sr-only">(current)</span></a>
      <a class="nav-link" href="#">Features</a>
      <a class="nav-link" href="#">Pricing</a>
      <a class="nav-link disabled">Disabled</a>
    </div>
  </div>
</nav>

您还可以在导航栏中使用下拉菜单。下拉菜单需要一个包装元素来定位，因此请务必为 .nav-item 和 .nav-link 使用单独的嵌套元素，如下所示。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
  <a class="navbar-brand" href="#">Navbar</a>
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-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 active">
        <a class="nav-link" href="#">Home <span class="sr-only">(current)</span></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-toggle="dropdown" aria-expanded="false">
          Dropdown link
        </a>
        <div class="dropdown-menu">
          <a class="dropdown-item" href="#">Action</a>
          <a class="dropdown-item" href="#">Another action</a>
          <a class="dropdown-item" href="#">Something else here</a>
        </div>
      </li>
    </ul>
  </div>
</nav>

表单

使用 .form-inline 在导航栏中放置各种表单控件和组件。

<nav class="navbar navbar-light bg-light">
  <form class="form-inline">
    <input class="form-control mr-sm-2" type="search" placeholder="Search" aria-label="Search">
    <button class="btn btn-outline-success my-2 my-sm-0" type="submit">Search</button>
  </form>
</nav>

.navbar 的直接子元素使用 flex 布局，并且默认情况下为 justify-content: space-between。根据需要使用其他 flex 实用工具 来调整此行为。

<nav class="navbar navbar-light bg-light">
  <a class="navbar-brand">Navbar</a>
  <form class="form-inline">
    <input class="form-control mr-sm-2" type="search" placeholder="Search" aria-label="Search">
    <button class="btn btn-outline-success my-2 my-sm-0" type="submit">Search</button>
  </form>
</nav>

输入组也适用

<nav class="navbar navbar-light bg-light">
  <form class="form-inline">
    <div class="input-group">
      <div class="input-group-prepend">
        <span class="input-group-text" id="basic-addon1">@</span>
      </div>
      <input type="text" class="form-control" placeholder="Username" aria-label="Username" aria-describedby="basic-addon1">
    </div>
  </form>
</nav>

这些导航栏表单中也支持各种按钮。这也是一个很好的提醒，即可以使用垂直对齐实用工具来对齐不同大小的元素。

<nav class="navbar navbar-light bg-light">
  <form class="form-inline">
    <button class="btn btn-outline-success" type="button">Main button</button>
    <button class="btn btn-sm btn-outline-secondary" type="button">Smaller button</button>
  </form>
</nav>

文本

导航栏可以使用 .navbar-text 包含一些文本。此类调整了文本字符串的垂直对齐和水平间距。

<nav class="navbar navbar-light bg-light">
  <span class="navbar-text">
    Navbar text with an inline element
  </span>
</nav>

根据需要与其他组件和实用工具混合搭配。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
  <a class="navbar-brand" href="#">Navbar w/ text</a>
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-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 mr-auto">
      <li class="nav-item active">
        <a class="nav-link" href="#">Home <span class="sr-only">(current)</span></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>
</nav>

配色方案

由于主题类和 background-color 实用工具的结合，对导航栏进行主题化从未如此简单。对于浅色背景色，可以选择 .navbar-light；对于深色背景色，可以选择 .navbar-dark。然后，使用 .bg-* 实用工具进行自定义。

<nav class="navbar navbar-dark bg-dark">
  <!-- Navbar content -->
</nav>

<nav class="navbar navbar-dark bg-primary">
  <!-- Navbar content -->
</nav>

<nav class="navbar navbar-light" style="background-color: #e3f2fd;">
  <!-- Navbar content -->
</nav>

容器

虽然不是必需的，但您可以将导航栏包装在 .container 中以将其居中放置在页面上。或者，您可以在 .navbar 中添加一个容器，以仅将 固定或静态顶部导航栏 的内容居中。

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

当容器位于导航栏中时，其水平填充在低于您指定的 .navbar-expand{-sm|-md|-lg|-xl} 类的断点处被移除。这确保了在您的导航栏折叠时，我们不会在较低视口中不必要地加倍填充。

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

放置

使用我们的 位置实用工具 将导航栏放置在非静态位置。从固定到顶部、固定到底部或粘贴到顶部（随着页面滚动，直到到达顶部，然后停留在那里）中进行选择。固定导航栏使用 position: fixed，这意味着它们是从 DOM 的正常流中提取出来的，并且可能需要自定义 CSS（例如，<body> 上的 padding-top）以防止与其他元素重叠。

另请注意，.sticky-top 使用 position: sticky，它并未在所有浏览器中得到完全支持。

<nav class="navbar navbar-light bg-light">
  <a class="navbar-brand" href="#">Default</a>
</nav>
<nav class="navbar fixed-top navbar-light bg-light">
  <a class="navbar-brand" href="#">Fixed top</a>
</nav>
<nav class="navbar fixed-bottom navbar-light bg-light">
  <a class="navbar-brand" href="#">Fixed bottom</a>
</nav>
<nav class="navbar sticky-top navbar-light bg-light">
  <a class="navbar-brand" href="#">Sticky top</a>
</nav>

滚动

向 .navbar-collapse（或其他导航栏子组件）添加 .navbar-nav-scroll 以启用在折叠导航栏的可切换内容中垂直滚动。默认情况下，滚动在 75vh（或视口高度的 75%）处启动，但你可以使用内联或自定义样式覆盖它。在导航栏展开时，在较大的视口中，内容将显示为在默认导航栏中的内容。

请注意，此行为会带来 overflow 的潜在缺点——当设置 overflow-y: auto（此处滚动内容所需）时，overflow-x 等效于 auto，这将裁剪一些水平内容。

这是一个使用 .navbar-nav-scroll 和 style="max-height: 100px;" 的导航栏示例，并带有一些额外的边距实用工具以实现最佳间距。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
  <a class="navbar-brand" href="#">Navbar scroll</a>
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-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 mr-auto my-2 my-lg-0 navbar-nav-scroll" style="max-height: 100px;">
      <li class="nav-item active">
        <a class="nav-link" href="#">Home <span class="sr-only">(current)</span></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-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">Link</a>
      </li>
    </ul>
    <form class="d-flex">
      <input class="form-control mr-2" type="search" placeholder="Search" aria-label="Search">
      <button class="btn btn-outline-success" type="submit">Search</button>
    </form>
  </div>
</nav>

响应式行为

导航栏可以使用 .navbar-toggler、.navbar-collapse 和 .navbar-expand{-sm|-md|-lg|-xl} 类来确定其内容何时在按钮后面折叠。结合其他实用工具，你可以轻松选择显示或隐藏特定元素的时间。

对于从不折叠的导航栏，请在导航栏上添加 .navbar-expand 类。对于始终折叠的导航栏，请不要添加任何 .navbar-expand 类。

切换器

导航栏切换器默认左对齐，但如果它们遵循 .navbar-brand 等同级元素，它们将自动右对齐。反转标记将反转切换器的放置。以下是不同切换样式的示例。

在最小的断点处不显示 .navbar-brand

<nav class="navbar navbar-expand-lg navbar-light bg-light">
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-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 mr-auto mt-2 mt-lg-0">
      <li class="nav-item active">
        <a class="nav-link" href="#">Home <span class="sr-only">(current)</span></a>
      </li>
      <li class="nav-item">
        <a class="nav-link" href="#">Link</a>
      </li>
      <li class="nav-item">
        <a class="nav-link disabled">Disabled</a>
      </li>
    </ul>
    <form class="form-inline my-2 my-lg-0">
      <input class="form-control mr-sm-2" type="search" placeholder="Search" aria-label="Search">
      <button class="btn btn-outline-success my-2 my-sm-0" type="submit">Search</button>
    </form>
  </div>
</nav>

品牌名称显示在左侧，切换器显示在右侧

<nav class="navbar navbar-expand-lg navbar-light bg-light">
  <a class="navbar-brand" href="#">Navbar</a>
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-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 mr-auto mt-2 mt-lg-0">
      <li class="nav-item active">
        <a class="nav-link" href="#">Home <span class="sr-only">(current)</span></a>
      </li>
      <li class="nav-item">
        <a class="nav-link" href="#">Link</a>
      </li>
      <li class="nav-item">
        <a class="nav-link disabled">Disabled</a>
      </li>
    </ul>
    <form class="form-inline my-2 my-lg-0">
      <input class="form-control mr-sm-2" type="search" placeholder="Search">
      <button class="btn btn-outline-success my-2 my-sm-0" type="submit">Search</button>
    </form>
  </div>
</nav>

切换器显示在左侧，品牌名称显示在右侧

<nav class="navbar navbar-expand-lg navbar-light bg-light">
  <button class="navbar-toggler" type="button" data-toggle="collapse" data-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 mr-auto mt-2 mt-lg-0">
      <li class="nav-item active">
        <a class="nav-link" href="#">Home <span class="sr-only">(current)</span></a>
      </li>
      <li class="nav-item">
        <a class="nav-link" href="#">Link</a>
      </li>
      <li class="nav-item">
        <a class="nav-link disabled">Disabled</a>
      </li>
    </ul>
    <form class="form-inline my-2 my-lg-0">
      <input class="form-control mr-sm-2" type="search" placeholder="Search" aria-label="Search">
      <button class="btn btn-outline-success my-2 my-sm-0" type="submit">Search</button>
    </form>
  </div>
</nav>

外部内容

有时你希望使用折叠插件为结构上位于 .navbar 之外的内容触发容器元素。因为我们的插件在 id 和 data-target 匹配上运行，所以这很容易做到！

<div class="fixed-top">
  <div class="collapse" id="navbarToggleExternalContent">
    <div class="bg-dark p-4">
      <h5 class="text-white h4">Collapsed content</h5>
      <span class="text-muted">Toggleable via the navbar brand.</span>
    </div>
  </div>
  <nav class="navbar navbar-dark bg-dark">
    <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarToggleExternalContent" aria-controls="navbarToggleExternalContent" aria-expanded="false" aria-label="Toggle navigation">
      <span class="navbar-toggler-icon"></span>
    </button>
  </nav>
</div>

当你这样做时，我们建议包含额外的 JavaScript，以便在打开容器时以编程方式将焦点移到容器。否则，键盘用户和辅助技术用户可能很难找到新显示的内容 - 尤其是如果打开的容器在文档结构中位于切换器之前。我们还建议确保切换器具有 aria-controls 属性，指向内容容器的 id。理论上，这允许辅助技术用户直接从切换器跳转到它控制的容器——但目前对此的支持相当不完善。