Distintivi
Documentazione ed esempi per badge, il nostro piccolo conteggio e componente di etichettatura.
Esempi
I badge vengono ridimensionati in base alle dimensioni dell'elemento padre immediato utilizzando le dimensioni e em
le unità del carattere relative. A partire dalla v5, i badge non hanno più stili di messa a fuoco o al passaggio del mouse per i collegamenti.
Intestazioni
Esempio di intestazioneNuovo
Esempio di intestazioneNuovo
Esempio di intestazioneNuovo
Esempio di intestazioneNuovo
Esempio di intestazioneNuovo
Esempio di intestazioneNuovo
<h1>Example heading <span class="badge bg-secondary">New</span></h1>
<h2>Example heading <span class="badge bg-secondary">New</span></h2>
<h3>Example heading <span class="badge bg-secondary">New</span></h3>
<h4>Example heading <span class="badge bg-secondary">New</span></h4>
<h5>Example heading <span class="badge bg-secondary">New</span></h5>
<h6>Example heading <span class="badge bg-secondary">New</span></h6>
Bottoni
I badge possono essere utilizzati come parte di collegamenti o pulsanti per fornire un contatore.
<button type="button" class="btn btn-primary">
Notifications <span class="badge text-bg-secondary">4</span>
</button>
Tieni presente che, a seconda di come vengono utilizzati, i badge possono creare confusione per gli utenti di lettori di schermo e tecnologie assistive simili. Mentre lo stile dei badge fornisce un indizio visivo del loro scopo, a questi utenti verrà semplicemente presentato il contenuto del badge. A seconda della situazione specifica, questi badge possono sembrare parole o numeri aggiuntivi casuali alla fine di una frase, un collegamento o un pulsante.
A meno che il contesto non sia chiaro (come con l'esempio "Notifiche", in cui si comprende che il "4" è il numero di notifiche), considerare di includere un contesto aggiuntivo con un pezzo di testo aggiuntivo visivamente nascosto.
Posizionato
Utilizzare le utilità per modificare a .badge
e posizionarlo nell'angolo di un collegamento o di un pulsante.
<button type="button" class="btn btn-primary position-relative">
Inbox
<span class="position-absolute top-0 start-100 translate-middle badge rounded-pill bg-danger">
99+
<span class="visually-hidden">unread messages</span>
</span>
</button>
Puoi anche sostituire la .badge
classe con alcune utilità in più senza contare per un indicatore più generico.
<button type="button" class="btn btn-primary position-relative">
Profile
<span class="position-absolute top-0 start-100 translate-middle p-2 bg-danger border border-light rounded-circle">
<span class="visually-hidden">New alerts</span>
</span>
</button>
Colori di sfondo
Aggiunto nella v5.2.0Imposta un background-color
primo piano contrastante color
con i nostri .text-bg-{color}
aiutanti . In precedenza era necessario accoppiare manualmente la tua scelta .text-{color}
e .bg-{color}
le utilità per lo styling, che puoi comunque utilizzare se preferisci.
<span class="badge text-bg-primary">Primary</span>
<span class="badge text-bg-secondary">Secondary</span>
<span class="badge text-bg-success">Success</span>
<span class="badge text-bg-danger">Danger</span>
<span class="badge text-bg-warning">Warning</span>
<span class="badge text-bg-info">Info</span>
<span class="badge text-bg-light">Light</span>
<span class="badge text-bg-dark">Dark</span>
Trasmettere significato alle tecnologie assistive
L'uso del colore per aggiungere significato fornisce solo un'indicazione visiva, che non verrà trasmessa agli utenti di tecnologie assistive, come i lettori di schermo. Assicurati che le informazioni denotate dal colore siano ovvie dal contenuto stesso (ad esempio il testo visibile), o siano incluse attraverso mezzi alternativi, come testo aggiuntivo nascosto con la .visually-hidden
classe.
Distintivi per pillole
Usa la .rounded-pill
classe di utilità per rendere i badge più arrotondati con un border-radius
.
<span class="badge rounded-pill text-bg-primary">Primary</span>
<span class="badge rounded-pill text-bg-secondary">Secondary</span>
<span class="badge rounded-pill text-bg-success">Success</span>
<span class="badge rounded-pill text-bg-danger">Danger</span>
<span class="badge rounded-pill text-bg-warning">Warning</span>
<span class="badge rounded-pill text-bg-info">Info</span>
<span class="badge rounded-pill text-bg-light">Light</span>
<span class="badge rounded-pill text-bg-dark">Dark</span>
CSS
Variabili
Aggiunto nella v5.2.0Come parte dell'approccio in evoluzione delle variabili CSS di Bootstrap, i badge ora utilizzano le variabili CSS locali .badge
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}badge-padding-x: #{$badge-padding-x};
--#{$prefix}badge-padding-y: #{$badge-padding-y};
@include rfs($badge-font-size, --#{$prefix}badge-font-size);
--#{$prefix}badge-font-weight: #{$badge-font-weight};
--#{$prefix}badge-color: #{$badge-color};
--#{$prefix}badge-border-radius: #{$badge-border-radius};
variabili Sas
$badge-font-size: .75em;
$badge-font-weight: $font-weight-bold;
$badge-color: $white;
$badge-padding-y: .35em;
$badge-padding-x: .65em;
$badge-border-radius: $border-radius;