Skip to main content Skip to docs navigation
View on GitHub

Breadcrumb路径导航

Indicate the current page’s location within a navigational hierarchy that automatically adds separators via CSS.指示当前页面在导航层次结构中的位置，导航层次结构通过CSS自动添加分隔符。

On this page本页内容

Example例子

Use an ordered or unordered list with linked list items to create a minimally styled breadcrumb. 使用带有链接列表项的有序或无序列表来创建样式最少的面包屑。Use our utilities to add additional styles as desired.使用我们的实用程序可以根据需要添加其他样式。

<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item active" aria-current="page">Home</li>
</ol>
</nav>
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#">Home</a></li>
<li class="breadcrumb-item active" aria-current="page">Library</li>
</ol>
</nav>
<nav aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#">Home</a></li>
<li class="breadcrumb-item"><a href="#">Library</a></li>
<li class="breadcrumb-item active" aria-current="page">Data</li>
</ol>
</nav>

Dividers分隔符

Dividers are automatically added in CSS through ::before and content. 分隔符通过::before和content自动添加到CSS中。They can be changed by modifying a local CSS custom property --bs-breadcrumb-divider, or through the $breadcrumb-divider Sass variable — and $breadcrumb-divider-flipped for its RTL counterpart, if needed. 如果需要，可以通过修改局部CSS自定义属性--bs-breadcrumb-divider，或者通过$breadcrumb-divider Sass变量来更改它们，而$breadcrumb-divider-flipped用于其RTL对应项。We default to our Sass variable, which is set as a fallback to the custom property. 我们默认使用Sass变量，该变量设置为自定义属性的回退。This way, you get a global divider that you can override without recompiling CSS at any time.这样，您就得到了一个全局分隔符，您可以在任何时候重写它，而无需重新编译CSS。

<nav style="--bs-breadcrumb-divider: '>';" aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#">Home</a></li>
<li class="breadcrumb-item active" aria-current="page">Library</li>
</ol>
</nav>

When modifying via Sass, the quote function is required to generate the quotes around a string. 通过Sass修改时，需要quote函数来生成字符串周围的引号。For example, using > as the divider, you can use this:例如，使用>作为分隔符，您可以使用以下内容：

$breadcrumb-divider: quote(">");

It’s also possible to use an embedded SVG icon. 还可以使用嵌入式SVG图标。Apply it via our CSS custom property, or use the Sass variable.通过CSS自定义属性应用它，或者使用Sass变量。

<nav style="--bs-breadcrumb-divider: url(&#34;data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='8' height='8'%3E%3Cpath d='M2.5 0L1 1.5 3.5 4 1 6.5 2.5 8l4-4-4-4z' fill='currentColor'/%3E%3C/svg%3E&#34;);" aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#">Home</a></li>
<li class="breadcrumb-item active" aria-current="page">Library</li>
</ol>
</nav>
$breadcrumb-divider: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='8' height='8'%3E%3Cpath d='M2.5 0L1 1.5 3.5 4 1 6.5 2.5 8l4-4-4-4z' fill='currentColor'/%3E%3C/svg%3E");

You can also remove the divider setting --bs-breadcrumb-divider: ''; (empty strings in CSS custom properties counts as a value), or setting the Sass variable to $breadcrumb-divider: none;.您还可以通过设置--bs-breadcrumb-divider: '';来删除分隔器（CSS自定义属性中的空字符串将计为一个值），或者将Sass变量设置为$breadcrumb-divider: none;。

<nav style="--bs-breadcrumb-divider: '';" aria-label="breadcrumb">
<ol class="breadcrumb">
<li class="breadcrumb-item"><a href="#">Home</a></li>
<li class="breadcrumb-item active" aria-current="page">Library</li>
</ol>
</nav>
$breadcrumb-divider: none;

Accessibility可访问性

Since breadcrumbs provide a navigation, it’s a good idea to add a meaningful label such as aria-label="breadcrumb" to describe the type of navigation provided in the <nav> element, as well as applying an aria-current="page" to the last item of the set to indicate that it represents the current page.因为路径导航提供了导航，所以最好添加一个有意义的标签，比如aria-label="breadcrumb"以描述<nav>元素中提供的导航类型，并且应将aria-current="page"应用到集合的最后一项，以指示它代表当前页面。

For more information, see the WAI-ARIA Authoring Practices for the breadcrumb pattern.有关更多信息，请参阅路径导航模式的WAI-ARIA创作实践。

Sass

Variables变量

$breadcrumb-font-size:              null;
$breadcrumb-padding-y:              0;
$breadcrumb-padding-x:              0;
$breadcrumb-item-padding-x:         .5rem;
$breadcrumb-margin-bottom:          1rem;
$breadcrumb-bg:                     null;
$breadcrumb-divider-color:          $gray-600;
$breadcrumb-active-color:           $gray-600;
$breadcrumb-divider:                quote("/");
$breadcrumb-divider-flipped:        $breadcrumb-divider;
$breadcrumb-border-radius:          null;