Przejdź do głównej zawartości Przejdź do nawigacji w dokumentach
Check
in English

Bułka tarta

Wskaż lokalizację bieżącej strony w hierarchii nawigacyjnej, która automatycznie dodaje separatory za pomocą CSS.

Na tej stronie

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.

html
<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ą ::beforei content. Można je zmienić, modyfikując lokalną niestandardową właściwość CSS --bs-breadcrumb-dividerlub za pomocą $breadcrumb-dividerzmiennej Sass — i $breadcrumb-divider-flippedw 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.

html
<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-dividerescape-svg()

html
<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='%236c757d'/%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,<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;.

html
<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.0

W ramach ewoluującego podejścia Bootstrap do zmiennych CSS, bułka tarta używa teraz lokalnych zmiennych CSS w .breadcrumbcelu 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;