面包屑導航（Breadcrumb）

指示當前頁在導航層次結構中的位置，該層次結構通過CSS自動添加分隔符。

On this page

例子

使用帶有鏈接列表項的有序或無序列表創建樣式最簡的面包屑。使用我們的實用程序添加所需的其他樣式。

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

分隔符

分隔符通過::before和content自動添加到CSS中。如果需要的話，可以通過修改本地CSS自定義屬性--bs-breadcrumb-divider，或者通過$breadcrumb-divider Sass變量。我們默認使用Sass變量，該變量被設置為自定義屬性的回退。這樣，您就得到了一個全局分隔符，您可以隨時重寫它而無需重新編譯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>

通過Sass進行修改時，需要quote函數來生成字符串周圍的引號。例如，使用 > 作為分隔符，可以使用：

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

也可以使用嵌入式SVG圖標。通過我們的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");

您還可以刪除分隔符設置--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;

輔助功能

由于breadcrumbs提供了一個導航，因此最好添加一個有意義的標簽，例如aria-label="breadcrumb" 來描述<nav>元素中提供的導航類型，并將aria-current="page"應用于集合的最后一個項，以指示它代表當前頁面。

有關更多信息，請參閱breadcrumb模式的WAI-ARIA創作實踐。 WAI-ARIA Authoring Practices for the breadcrumb pattern.

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;