Percorso di navigazione
Indica la posizione della pagina corrente all'interno di una gerarchia di navigazione che aggiunge automaticamente i separatori tramite CSS.
Esempio
Usa un elenco ordinato o non ordinato con elementi di elenco collegati per creare un breadcrumb dallo stile minimale. Usa le nostre utilità per aggiungere stili aggiuntivi come desideri.
<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>
Divisori
I divisori vengono aggiunti automaticamente in CSS tramite ::before
e content
. Possono essere modificati modificando una proprietà personalizzata CSS locale --bs-breadcrumb-divider
o tramite la $breadcrumb-divider
variabile Sass e $breadcrumb-divider-flipped
per la sua controparte RTL, se necessario. Per impostazione predefinita, utilizziamo la nostra variabile Sass, che è impostata come fallback alla proprietà personalizzata. In questo modo, ottieni un divisore globale che puoi sovrascrivere senza ricompilare CSS in qualsiasi momento.
<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>
Quando si modifica tramite Sass, è necessaria la funzione quote per generare le virgolette attorno a una stringa. Ad esempio, usando >
come divisore, puoi usare questo:
$breadcrumb-divider: quote(">");
È anche possibile utilizzare un'icona SVG incorporata . Applicalo tramite la nostra proprietà personalizzata CSS o utilizza la variabile Sass.
Utilizzo di SVG incorporato
L'inclusione di SVG come URI di dati richiede l'escape dell'URL di alcuni caratteri, in particolare <
, >
e #
. Ecco perché la $breadcrumb-divider
variabile viene passata attraverso la nostra escape-svg()
funzione Sass . Quando si utilizza la proprietà personalizzata CSS, è necessario eseguire l'escape dell'URL da soli. Leggi le spiegazioni di Kevin Weber su CodePen per informazioni dettagliate su cosa sfuggire.
<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>");
Puoi anche rimuovere l'impostazione del divisore --bs-breadcrumb-divider: '';
(le stringhe vuote nelle proprietà personalizzate CSS contano come un valore) o impostare la variabile Sass su $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;
Accessibilità
Poiché i breadcrumb forniscono una navigazione, è una buona idea aggiungere un'etichetta significativa come aria-label="breadcrumb"
per descrivere il tipo di navigazione fornito <nav>
nell'elemento, oltre ad applicare un aria-current="page"
all'ultimo elemento del set per indicare che rappresenta la pagina corrente.
Per ulteriori informazioni, consulta la breadcrumb pattern ARIA Authoring Practices Guide .
CSS
Variabili
Aggiunto nella v5.2.0Come parte dell'approccio in evoluzione delle variabili CSS di Bootstrap, i breadcrumb ora utilizzano le variabili CSS locali .breadcrumb
per una migliore personalizzazione in tempo reale. I valori per le variabili CSS vengono impostati tramite Sass, quindi anche la personalizzazione di Sass è ancora supportata.
--#{$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};
variabili Sas
$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;