麵包屑導覽(Breadcrumb)
透過 CSS 自動加入分隔符號,指示目前頁面在導覽階層中的位置。
範例(Example)
使用有序或無序列表搭配連結列表項目來建立最基本樣式的麵包屑導覽。使用我們的通用類別來根據需要加入額外樣式。
<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)
分隔符號透過 ::before 和 content 在 CSS 中自動加入。可以透過修改本地 CSS 自訂屬性 --bs-breadcrumb-divider,或透過 $breadcrumb-divider Sass 變數來變更它們——如有需要,RTL 對應版本為 $breadcrumb-divider-flipped。我們預設使用 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 變數。
嵌入式 SVG 需要正確跳脫的字元。 一些保留字元,如 <、> 和 #,必須進行 URL 編碼或跳脫。我們使用 escape-svg() Sass 函式對 $breadcrumb-divider 變數進行處理。當自訂 CSS 變數時,您必須自行處理這個問題。閱讀 Kevin Weber 在 CodePen 上的說明以了解更多資訊。
<nav style="--bs-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='%236c757d'/%3E%3C/svg%3E");" 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,<svg xmlns='http://www.w3.org/2000/svg' width='8' height='8'><path d='M2.5 0L1 1.5 3.5 4 1 6.5 2.5 8l4-4-4-4z' fill='#{$breadcrumb-divider-color}'/></svg>");
您也可以透過設定 --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)
由於麵包屑導覽提供導覽功能,最好在 <nav> 元素上加入有意義的標籤,如 aria-label="breadcrumb" 來描述所提供的導覽類型,並在集合的最後一個項目上套用 aria-current="page" 來表示它代表目前頁面。
更多資訊,請參閱 ARIA 編寫實踐指南麵包屑導覽模式。
CSS
變數(Variables)
Added in v5.2.0作為 Bootstrap 持續演進的 CSS 變數方法的一部分,麵包屑導覽現在在 .breadcrumb 上使用本地 CSS 變數來增強即時自訂功能。CSS 變數的值透過 Sass 設定,因此 Sass 自訂仍然受支援。
--#{$prefix}breadcrumb-padding-x: #{$breadcrumb-padding-x};
--#{$prefix}breadcrumb-padding-y: #{$breadcrumb-padding-y};
--#{$prefix}breadcrumb-margin-bottom: #{$breadcrumb-margin-bottom};
@include rfs($breadcrumb-font-size, --#{$prefix}breadcrumb-font-size);
--#{$prefix}breadcrumb-bg: #{$breadcrumb-bg};
--#{$prefix}breadcrumb-border-radius: #{$breadcrumb-border-radius};
--#{$prefix}breadcrumb-divider-color: #{$breadcrumb-divider-color};
--#{$prefix}breadcrumb-item-padding-x: #{$breadcrumb-item-padding-x};
--#{$prefix}breadcrumb-item-active-color: #{$breadcrumb-active-color};
Sass 變數(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: var(--#{$prefix}secondary-color);
$breadcrumb-active-color: var(--#{$prefix}secondary-color);
$breadcrumb-divider: quote("/");
$breadcrumb-divider-flipped: $breadcrumb-divider;
$breadcrumb-border-radius: null;