在GitHub上查看

导航栏

Bootstrap强大的响应式导航标题导航栏的文档和示例。 包括对品牌,导航等的支持,包括对我们的合并插件的支持。

工作原理

在开始使用导航栏之前,您需要了解以下几点:

  • 导航栏需要使用 .navbar-expand{-sm|-md|-lg|-xl|-xxl} 来修饰 .navbar ,以进行响应式折叠和配色方案类。
  • 导航栏及其内容默认情况下是流畅的。 更改 导航栏容器以不同方式限制其水平宽度。
  • 使用我们的spacingflex 类来控制导航栏中的间距和对齐方式。
  • 导航栏默认情况下是响应式的,但是您可以轻松地对其进行修改以进行更改。 响应行为取决于我们的Collapse JavaScript插件。
  • 通过使用 <nav> 元素来确保可访问性,或者,如果使用更通用的元素(如 <div>),则在每个导航栏中添加 role="navigation" ,以明确将其标识为辅助技术用户的地标区域。
  • 通过使用 aria-current="page" 表示当前页面或使用 aria-current="true" 表示集中的当前项目。
此组件的动画效果依赖于 prefers-reduced-motion 媒体查询。请参阅我们的可访问文档的reduce motion部分

导航栏属性

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

  • .navbar-brand 为您的公司,产品或项目名称。
  • .navbar-nav 用于全高和轻量级导航(包括对下拉菜单的支持)。
  • .navbar-toggler 与我们的折叠插件和其他导航切换行为配合使用。
  • 用于任何表单控件和操作的伸缩和间距实用工具。
  • .navbar-text 用于添加垂直居中的文本字符串。
  • .collapse.navbar-collapse 用于通过父断点分组和隐藏导航栏内容。

这是响应式轻型导航栏中包含的所有子组件的示例,该导航栏会在 lg (大)断点处自动折叠。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
<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="#" id="navbarDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false">
        Dropdown
      </a>
      <ul class="dropdown-menu" aria-labelledby="navbarDropdown">
        <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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
    </li>
  </ul>
  <form class="d-flex">
    <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>

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

标牌属性

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

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

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

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

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

Navbar导航链接以我们的 .nav 选项及其自己的修饰符类为基础,并且需要使用切换器类来进行适当的响应式样式。 导航栏中的导航也将不断扩大,以占据尽可能多的水平空间,以使导航栏内容安全对齐。

活动状态(带有 .active)表示当前页面可以直接应用于 .nav-link 或它们的直接父 .nav-item

请注意,您还应该在 .nav-link 本身上添加 aria-current 属性。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
    </li>
  </ul>
</div>
</div>
</nav>

And because we use classes for our navs, you can avoid the list-based approach entirely if you like.

<nav class="navbar navbar-expand-lg navbar-light bg-light">
<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
  </div>
</div>
</div>
</nav>

You can also use dropdowns in your navbar. Dropdown menus require a wrapping element for positioning, so be sure to use separate and nested elements for .nav-item and .nav-link as shown below.

<nav class="navbar navbar-expand-lg navbar-light bg-light">
<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="#" id="navbarDropdownMenuLink" role="button" data-bs-toggle="dropdown" aria-expanded="false">
        Dropdown link
      </a>
      <ul class="dropdown-menu" aria-labelledby="navbarDropdownMenuLink">
        <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>

表单属性

将各种表单控件和组件放在导航栏中:

<nav class="navbar navbar-light bg-light">
<div class="container-fluid">
<form class="d-flex">
  <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。 根据需要使用其他flex实用程序来调整此行为。

<nav class="navbar navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand">Navbar</a>
<form class="d-flex">
  <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>

输入组也起作用。 如果导航栏是整个表单,或者大部分是表单,则可以使用 <form> 元素作为容器并保存一些HTML。

<nav class="navbar navbar-light bg-light">
<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>

Various buttons are supported as part of these navbar forms, too. This is also a great reminder that vertical alignment utilities can be used to align different sized elements.

<nav class="navbar navbar-light bg-light">
<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>

文本属性

导航栏可以在 .navbar-text 的帮助下包含一些文本。 此类调整文本字符串的垂直对齐方式和水平间距。

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

根据需要与其他组件和实用程序混合并匹配。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
<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>

配色方案

由于主题类和 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">
<div class="container-fluid">
  <a class="navbar-brand" href="#">Navbar</a>
</div>
</nav>
</div>

使用任何响应式容器可以更改导航栏中内容的显示宽度。

<nav class="navbar navbar-expand-lg navbar-light bg-light">
<div class="container-md">
<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">
<div class="container-fluid">
<a class="navbar-brand" href="#">Default</a>
</div>
</nav>
<nav class="navbar fixed-top navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand" href="#">Fixed top</a>
</div>
</nav>
<nav class="navbar fixed-bottom navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand" href="#">Fixed bottom</a>
</div>
</nav>
<nav class="navbar sticky-top navbar-light bg-light">
<div class="container-fluid">
<a class="navbar-brand" href="#">Sticky top</a>
</div>
</nav>

导航栏的响应行为

导航栏可以使用 .navbar-toggler.navbar-collapse.navbar-expand{-sm|-md|-lg|-xl|-xxl} 来确定何时其内容折叠在按钮后面。 与其他实用程序结合使用,您可以轻松选择何时显示或隐藏特定元素。

对于永不折叠的导航栏,请在导航栏上添加 .navbar-expand 类。 对于经常折叠的导航栏,请不要添加任何 .navbar-expand 类。

切换器

导航栏切换器默认情况下是左对齐的,但是如果它们跟随 .navbar-brand 之类的兄弟元素,它们将自动对齐到最右端。 反转标记将反转切换器的位置。 以下是不同切换样式的示例。

在最小的断点没有显示 .navbar-brand :

<nav class="navbar navbar-expand-lg navbar-light bg-light">
<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
    </li>
  </ul>
  <form class="d-flex">
    <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>

左侧显示标牌名称,右侧显示切换器:

<nav class="navbar navbar-expand-lg navbar-light bg-light">
<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
    </li>
  </ul>
  <form class="d-flex">
    <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>

左侧带有切换开关,右侧带有标牌名称:

<nav class="navbar navbar-expand-lg navbar-light bg-light">
<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" href="#" tabindex="-1" aria-disabled="true">Disabled</a>
    </li>
  </ul>
  <form class="d-flex">
    <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>

导航栏外部使用

有时,您想使用折叠插件为结构上位于 .navbar 之外的内容触发容器元素。 由于我们的插件可以匹配 iddata-bs-target 匹配,因此很容易做到!

<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">
<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>

当您执行此操作时,建议您添加其他JavaScript,以在打开容器时以编程方式将焦点移到容器上。 否则,键盘用户和辅助技术用户可能会很难找到新显示的内容-特别是如果打开的容器在文档结构中的切换器之前。 我们还建议确保切换器具有 aria-controls 属性,指向内容容器的 id 。 从理论上讲,这允许辅助技术用户直接从切换器跳到其控制的容器中-但是对此的支持目前还很少。