Bułka tarta
Wskaż lokalizację bieżącej strony w hierarchii nawigacyjnej, która automatycznie dodaje separatory za pomocą CSS.
Przykład
Użyj uporządkowanej lub nieuporządkowanej listy z połączonymi elementami listy, aby utworzyć minimalnie stylizowany element nawigacyjny. Skorzystaj z naszych narzędzi, aby w razie potrzeby dodać dodatkowe style.
<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>
Dzielniki
Dzielniki są automatycznie dodawane w CSS za pomocą ::before
i content
. Można je zmienić, modyfikując lokalną niestandardową właściwość CSS --bs-breadcrumb-divider
lub za pomocą $breadcrumb-divider
zmiennej Sass — i $breadcrumb-divider-flipped
w razie potrzeby dla jej odpowiednika RTL. Domyślnie używamy naszej zmiennej Sass, która jest ustawiona jako rezerwa do właściwości niestandardowej. W ten sposób otrzymujesz globalny dzielnik, który możesz w dowolnym momencie przesłonić bez ponownej kompilacji 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>
Podczas modyfikowania przez Sass funkcja cytatu jest wymagana do wygenerowania cudzysłowów wokół ciągu. Na przykład, używając >
jako dzielnika, możesz użyć tego:
$breadcrumb-divider: quote(">");
Możliwe jest również użycie osadzonej ikony SVG . Zastosuj go za pomocą naszej niestandardowej właściwości CSS lub użyj zmiennej Sass.
Korzystanie z osadzonego SVG
Wstawianie SVG jako identyfikatora URI danych wymaganego do zmiany adresu URL na kilka znaków, w szczególności <
i . Dlatego zmienna jest przekazywana przez naszą funkcję Sass . Korzystając z niestandardowej właściwości CSS, musisz samodzielnie zmienić adres URL swojego SVG. Przeczytaj wyjaśnienia Kevina Webera na temat CodePen, aby uzyskać szczegółowe informacje na temat tego, przed czym należy uciec.>
#
$breadcrumb-divider
escape-svg()
<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>");
Możesz także usunąć ustawienie dzielnika --bs-breadcrumb-divider: '';
(puste ciągi we właściwościach niestandardowych CSS liczą się jako wartość) lub ustawić zmienną Sass na $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;
Dostępność
Ponieważ bułka tarta zapewnia nawigację, dobrym pomysłem jest dodanie znaczącej etykiety, takiej jak aria-label="breadcrumb"
opis typu nawigacji dostarczonej w <nav>
elemencie, a także zastosowanie aria-current="page"
do ostatniego elementu zestawu, aby wskazać, że reprezentuje on bieżącą stronę.
Aby uzyskać więcej informacji, zobacz wzorzec breadcrumb ARIA Authoring Practices Guide .
CSS
Zmienne
Dodano w wersji 5.2.0W ramach ewoluującego podejścia Bootstrap do zmiennych CSS, bułka tarta używa teraz lokalnych zmiennych CSS w .breadcrumb
celu udoskonalenia dostosowywania w czasie rzeczywistym. Wartości zmiennych CSS są ustawiane przez Sass, więc dostosowywanie Sass jest nadal obsługiwane.
--#{$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};
Zmienne Sassa
$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;