Distintivi

Documentazione ed esempi per badge, il nostro piccolo conteggio e componente di etichettatura.

Su questa pagina

Esempi

I badge vengono ridimensionati in base alle dimensioni dell'elemento padre immediato utilizzando le dimensioni e emle 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

<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 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 .badgee 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 .badgeclasse 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

Usa le nostre classi di utilità in background per modificare rapidamente l'aspetto di un badge. Tieni presente che quando utilizzi il valore predefinito di Bootstrap .bg-light, probabilmente avrai bisogno di un'utilità per il colore del testo come .text-darkper uno stile corretto. Questo perché le utilità in background non impostano altro che background-color.

Primario Secondario Successo Pericolo Avvertimento Informazioni Luce Scuro

<span class="badge bg-primary">Primary</span>
<span class="badge bg-secondary">Secondary</span>
<span class="badge bg-success">Success</span>
<span class="badge bg-danger">Danger</span>
<span class="badge bg-warning text-dark">Warning</span>
<span class="badge bg-info text-dark">Info</span>
<span class="badge bg-light text-dark">Light</span>
<span class="badge 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-hiddenclasse.

Distintivi per pillole

Usa la .rounded-pillclasse di utilità per rendere i badge più arrotondati con un border-radius.

Primario Secondario Successo Pericolo Avvertimento Informazioni Luce Scuro

<span class="badge rounded-pill bg-primary">Primary</span>
<span class="badge rounded-pill bg-secondary">Secondary</span>
<span class="badge rounded-pill bg-success">Success</span>
<span class="badge rounded-pill bg-danger">Danger</span>
<span class="badge rounded-pill bg-warning text-dark">Warning</span>
<span class="badge rounded-pill bg-info text-dark">Info</span>
<span class="badge rounded-pill bg-light text-dark">Light</span>
<span class="badge rounded-pill bg-dark">Dark</span>

Sass

Variabili

$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;