Bootstrap 强大的响应式导航标题导航栏的文档和示例。 包括对品牌、导航等的支持,包括对我们的折叠插件的支持。
在开始使用导航栏之前,您需要了解以下内容:
.navbar-expand{-sm|-md|-lg|-xl|-xxl}
包装 .navbar
以进行响应式折叠和配色方案类。container
以不同方式限制其水平宽度。spacing
和 flex
实用程序类来控制导航栏中的间距和对齐方式。<nav>
元素确保可访问性,或者,如果使用更通用的元素,例如 <div>
,则添加 role="navigation";
到每个导航栏,以明确地将其标识为辅助技术用户的标志性区域。aria-current="page"
或对集合中的当前项目使用 aria-current="true"
来指示当前项目。prefers-reduced-motion
媒体查询。导航栏内置了对少数子组件的支持。 根据需要从以下选项中进行选择:
.navbar-brand
为您的公司、产品或项目名称。.navbar-nav
用于全高度和轻量级导航(包括对下拉菜单的支持)。.navbar-toggler
用于我们的折叠插件和其他导航切换行为。.navbar-text
用于添加垂直居中的文本字符串。.collapse.navbar-collapse
用于按父断点分组和隐藏导航栏内容。.navbar-scroll
以设置 max-height
和滚动扩展导航栏内容。这是响应式轻主题导航栏中包含的所有子组件的示例,该导航栏在 lg
(大)断点处自动折叠。
<nav class="navbar navbar-expand-lg navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">导航栏</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="#">首页</a> </li> <li class="nav-item"> <a class="nav-link" href="#">链家</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"> 下拉 </a> <ul class="dropdown-menu" aria-labelledby="navbarDropdown"> <li><a class="dropdown-item" href="#">春天</a></li> <li><a class="dropdown-item" href="#">夏天</a></li> <li><hr class="dropdown-divider"></li> <li><a class="dropdown-item" href="#">秋天</a></li> </ul> </li> <li class="nav-item"> <a class="nav-link disabled">禁用的</a> </li> </ul> <form class="d-flex" role="search"> <input class="form-control me-2" type="search" placeholder="搜索关键字" aria-label="Search"> <button class="btn btn-outline-success" type="submit">搜素</button> </form> </div> </div> </nav>
此示例使用背景 (bg-light
) 和间距 (me-auto
, mb-2
, mb-lg-0
, me-2
) 实用程序类。
.navbar-brand
可以应用于大多数元素,但锚点效果最好,因为某些元素可能需要实用程序类或自定义样式。
使用 .navbar-brand
类在元素中添加您的文本。
<!-- As a link --> <nav class="navbar navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">品牌</a> </div> </nav> <!-- As a heading --> <nav class="navbar navbar-light bg-light"> <div class="container-fluid"> <span class="navbar-brand mb-0 h1">品牌</span> </div> </nav>图片
您可以将 .navbar-brand
中的文本替换为 <img>
。
<nav class="navbar navbar-light bg-light"> <div class="container"> <a class="navbar-brand" href="#"> <img src="images/logo-ico.png" alt="" width="26" height="26"> </a> </div> </nav>图片和文本
您还可以使用一些其他实用程序同时添加图像和文本。 注意在 <img>
上添加了 .d-inline-block
和 .align-text-top
。
<nav class="navbar navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#"> <img src="images/logo-ico.png" alt="" width="26" height="26" class="d-inline-block align-text-top"> 光年模板 </a> </div> </nav>
导航栏导航链接建立在我们的 .nav
选项之上,并带有自己的修饰符类,并且需要使用 toggler
类来获得正确的响应式样式。导航栏中的导航也将占用尽可能多的水平空间,以保持您的导航栏内容安全对齐。
在 .nav-link
上添加 .active
类来指示当前页面。
请注意,您还应该在活动的 .nav-link
上添加 aria-current
属性。
<nav class="navbar navbar-expand-lg navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">导航栏</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="#">首页</a> </li> <li class="nav-item"> <a class="nav-link" href="#">特征</a> </li> <li class="nav-item"> <a class="nav-link" href="#">价钱</a> </li> <li class="nav-item"> <a class="nav-link disabled">禁用的</a> </li> </ul> </div> </div> </nav>
而且因为我们为导航使用类,如果您愿意,您可以完全避免使用基于列表的方法。
<nav class="navbar navbar-expand-lg navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">导航栏</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="#">首页</a> <a class="nav-link" href="#">特征</a> <a class="nav-link" href="#">价钱</a> <a class="nav-link disabled">禁用的</a> </div> </div> </div> </nav>
您还可以在导航栏中使用下拉菜单。 下拉菜单需要一个包装元素来定位,因此请确保为 .nav-item
和 .nav-link
使用单独和嵌套的元素,如下所示。
<nav class="navbar navbar-expand-lg navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">导航栏</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="#">首页</a> </li> <li class="nav-item"> <a class="nav-link" href="#">特征</a> </li> <li class="nav-item"> <a class="nav-link" href="#">价钱</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"> 演义小说 </a> <ul class="dropdown-menu" aria-labelledby="navbarDropdownMenuLink"> <li><a class="dropdown-item" href="#">三国演义</a></li> <li><a class="dropdown-item" href="#">隋唐演义</a></li> <li><a class="dropdown-item" href="#">七侠五义</a></li> </ul> </li> </ul> </div> </div> </nav>
在导航栏中放置各种表单控件和组件:
<nav class="navbar navbar-light bg-light"> <div class="container-fluid"> <form class="d-flex" role="search"> <input class="form-control me-2" type="search" placeholder="搜索关键字" aria-label="Search"> <button class="btn btn-outline-success" type="submit">搜索</button> </form> </div> </nav>
.navbar
的直接子元素使用弹性布局,默认为 justify-content: space-between
。 根据需要使用其他flex 实用程序来调整此行为。
<nav class="navbar navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand">导航栏</a> <form class="d-flex" role="search"> <input class="form-control me-2" type="search" placeholder="搜索关键字" aria-label="Search"> <button class="btn btn-outline-success" type="submit">搜索</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>
这些导航栏表单也支持各种按钮。 这也是一个很好的提醒,垂直对齐实用程序可用于对齐不同大小的元素。
<nav class="navbar navbar-light bg-light"> <form class="container-fluid justify-content-start"> <button class="btn btn-outline-success me-2" type="button">主按钮</button> <button class="btn btn-sm btn-outline-secondary" type="button">较小的按钮</button> </form> </nav>
在 .navbar-text
的帮助下,导航栏可能包含一些文本。 此类调整文本字符串的垂直对齐和水平间距。
<nav class="navbar navbar-light bg-light"> <div class="container-fluid"> <span class="navbar-text"> 带有内联元素的导航栏文本 </span> </div> </nav>
根据需要与其他组件和实用程序混合搭配。
<nav class="navbar navbar-expand-lg navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">带有/文本的导航栏</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="#">首页</a> </li> <li class="nav-item"> <a class="nav-link" href="#">特征</a> </li> <li class="nav-item"> <a class="nav-link" href="#">价钱</a> </li> </ul> <span class="navbar-text"> 带有内联元素的导航栏文本 </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="#">导航栏</a> </div> </nav> </div>
使用任何响应式容器来更改导航栏中内容的显示宽度。
<nav class="navbar navbar-expand-lg navbar-light bg-light"> <div class="container-md"> <a class="navbar-brand" href="#">导航栏</a> </div> </nav>
使用我们的位置实用程序将导航栏放置在非静态位置。 选择固定到顶部、固定到底部、粘贴到顶部(随页面滚动直到它到达顶部,然后停留在那里)或固定到底部(随页面滚动直到它到达底部,然后停留 那里)。
固定导航栏使用 position: fixed
,这意味着它们是从 DOM 的正常流程中拉出来的,并且可能需要自定义 CSS(例如,<body>
上的 padding-top
) 以防止与其他元素重叠。
<nav class="navbar navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">默认</a> </div> </nav>
<nav class="navbar fixed-top navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">固定顶部</a> </div> </nav>
<nav class="navbar fixed-bottom navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">固定底部</a> </div> </nav>
<nav class="navbar sticky-top navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">粘在顶部</a> </div> </nav>
<nav class="navbar sticky-bottom navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">粘在底部</a> </div> </nav>
将 .navbar-nav-scroll
添加到 .navbar-nav
(或其他导航栏子组件)以在折叠导航栏的可切换内容中启用垂直滚动。 默认情况下,滚动开始于 75vh
(或视口高度的 75%),但您可以使用本地 CSS 自定义属性 --bs-navbar-height
覆盖它 或自定义样式。 当导航栏展开时,在较大的视口中,内容将像在默认导航栏中一样显示。
请注意,这种行为伴随着 overflow
的潜在缺点——当设置 overflow-y: auto
(需要在此处滚动内容)时,overflow-x
相当于 auto
,它将裁剪一些水平内容。
这是一个使用 .navbar-nav-scroll
和 style="--bs-scroll-height: 100px;"
的示例导航栏,以及一些额外的边距实用程序 以获得最佳间距。
<nav class="navbar navbar-expand-lg navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">导航栏滚动</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="#">首页</a> </li> <li class="nav-item"> <a class="nav-link" href="#">链接</a> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="navbarScrollingDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> 河图 </a> <ul class="dropdown-menu" aria-labelledby="navbarScrollingDropdown"> <li><a class="dropdown-item" href="#">陌上花早</a></li> <li><a class="dropdown-item" href="#">白马入芦花</a></li> <li><hr class="dropdown-divider"></li> <li><a class="dropdown-item" href="#">春日迟</a></li> </ul> </li> <li class="nav-item"> <a class="nav-link disabled">链接</a> </li> </ul> <form class="d-flex" role="search"> <input class="form-control me-2" type="search" placeholder="搜索关键字" aria-label="Search"> <button class="btn btn-outline-success" type="submit">搜索</button> </form> </div> </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="#">隐藏品牌</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="#">首页</a> </li> <li class="nav-item"> <a class="nav-link" href="#">链接</a> </li> <li class="nav-item"> <a class="nav-link disabled">禁用的</a> </li> </ul> <form class="d-flex" role="search"> <input class="form-control me-2" type="search" placeholder="搜索关键字" aria-label="Search"> <button class="btn btn-outline-success" type="submit">搜索</button> </form> </div> </div> </nav>
左侧显示品牌名称,右侧显示切换器:
<nav class="navbar navbar-expand-lg navbar-light bg-light"> <div class="container-fluid"> <a class="navbar-brand" href="#">导航栏</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="#">首页</a> </li> <li class="nav-item"> <a class="nav-link" href="#">链接</a> </li> <li class="nav-item"> <a class="nav-link disabled">禁用的</a> </li> </ul> <form class="d-flex" role="search"> <input class="form-control me-2" type="search" placeholder="搜索关键字" aria-label="Search"> <button class="btn btn-outline-success" type="submit">搜索</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="#">导航栏</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="#">首页</a> </li> <li class="nav-item"> <a class="nav-link" href="#">链接</a> </li> <li class="nav-item"> <a class="nav-link disabled">禁用的</a> </li> </ul> <form class="d-flex" role="search"> <input class="form-control me-2" type="search" placeholder="搜索关键字" aria-label="Search"> <button class="btn btn-outline-success" type="submit">搜索</button> </form> </div> </div> </nav>
有时您想使用折叠插件来触发结构上位于 .navbar
之外的内容的容器元素。 因为我们的插件适用于 id
和 data-bs-target
匹配,所以很容易做到!
<div class="collapse" id="navbarToggleExternalContent"> <div class="bg-dark p-4"> <h5 class="text-white h4">折叠的内容</h5> <span class="text-muted">可通过导航栏品牌进行切换。</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
。 从理论上讲,这允许辅助技术用户直接从切换器跳转到它控制的容器——但目前对此的支持相当不完整。
使用 offcanvas 插件将您的展开和折叠导航栏转换为 offcanvas 抽屉。 我们扩展了 offcanvas 默认样式并使用我们的 .navbar-expand-*
类来创建动态且灵活的导航侧边栏。
在下面的示例中,要创建一个始终在所有断点之间折叠的 offcanvas 导航栏,请完全省略 .navbar-expand-*
类。
<nav class="navbar navbar-light bg-light fixed-top"> <div class="container-fluid"> <a class="navbar-brand" href="#">Offcanvas 导航栏</a> <button class="navbar-toggler" type="button" data-bs-toggle="offcanvas" data-bs-target="#offcanvasNavbar" aria-controls="offcanvasNavbar"> <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="#">首页</a> </li> <li class="nav-item"> <a class="nav-link" href="#">链接</a> </li> <li class="nav-item dropdown"> <a class="nav-link dropdown-toggle" href="#" id="offcanvasNavbarDropdown" role="button" data-bs-toggle="dropdown" aria-expanded="false"> 下拉 </a> <ul class="dropdown-menu" aria-labelledby="offcanvasNavbarDropdown"> <li><a class="dropdown-item" href="#">北京</a></li> <li><a class="dropdown-item" href="#">上海</a></li> <li> <hr class="dropdown-divider"> </li> <li><a class="dropdown-item" href="#">深圳</a></li> </ul> </li> </ul> <form class="d-flex" role="search"> <input class="form-control me-2" type="search" placeholder="搜索关键字" aria-label="Search"> <button class="btn btn-outline-success" type="submit">搜索</button> </form> </div> </div> </div> </nav>
要创建一个在特定断点(如 lg
)处扩展为普通导航栏的 offcanvas 导航栏,请使用 .navbar-expand-lg
。
<nav class="navbar navbar-light navbar-expand-lg bg-light 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"> <span class="navbar-toggler-icon"></span> </button> <div class="offcanvas offcanvas-end" tabindex="-1" id="navbarOffcanvasLg" aria-labelledby="navbarOffcanvasLgLabel"> ... </div> </nav>