Skip to main content

Badge

Documentazione ed esempi del componente badge, utile per piccoli contatori ed etichette.

La grandezza di ogni badge si adatta come dimensione a quella del font (misurato in unità em) dell’elemento in cui è contenuto.

Titolo di esempio h1New
Titolo di esempio h2New
Titolo di esempio h3New
Titolo di esempio h4New
Titolo di esempio h5New
Titolo di esempio h6New
<div class="h1">Titolo di esempio h1<span class="badge bg-secondary">New</span></div>
<div class="h2">Titolo di esempio h2<span class="badge bg-secondary">New</span></div>
<div class="h3">Titolo di esempio h3<span class="badge bg-secondary">New</span></div>
<div class="h4">Titolo di esempio h4<span class="badge bg-secondary">New</span></div>
<div class="h5">Titolo di esempio h5<span class="badge bg-secondary">New</span></div>
<div class="h6">Titolo di esempio h6<span class="badge bg-secondary">New</span></div>

I badge possono essere utilizzati come parte di link o pulsanti per fornire un contatore.

<button type="button" class="btn btn-primary">
Notifiche <span class="badge bg-secondary">4</span>
</button>

Accessibilità

A seconda di come i badge vengono utilizzati, questi potrebbero confondere gli utenti che usano lo screen reader e tecnologie assistive simili. Mentre lo stile dei badge fornisce un indizio visivo sul loro scopo, a questi utenti saranno semplicemente presentati come semplice contenuto. 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”, dove si capisce che il “4” è il numero di notifiche), considera l’eventualità di includere un testo aggiuntivo nascosto.

<button type="button" class="btn btn-primary">
Profilo <span class="badge bg-secondary">9</span>
<span class="visually-hidden">Messaggi non letti</span>
</button>

Variazioni contestuali

Aggiungi una delle seguenti classi per modificare l’aspetto di un badge.

Primary Secondary Success Danger Warning
<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">Warning</span>

Trasmettere significato alle tecnologie assistive

L’uso del colore per aggiungere un significato fornisce solo un’indicazione visiva, che non sarà trasmesso agli utenti di tecnologie assistive – come gli screen reader. Assicurati che le informazioni denotate dal colore siano rese disponibili anche dal contenuto stesso (es.: il testo visibile), o siano incluse attraverso mezzi alternativi, come testo aggiuntivo nascosto con la classe .visually-hidden.

Badges arrotondati

Per rendere i badge arrotondati puoi usare la classe .rounded-pill.

Primary Secondary Success Danger Warning
<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">Warning</span>

Se hai bisogno che un badge sia anche un link, aggiungi una delle classi contestuali .badge-* sull’elemento <a>. Di conseguenza anche gli stati hover e focus saranno attivi sul badge.

<a href="#" class="badge bg-primary">Primary</a>
<a href="#" class="badge bg-secondary">Secondary</a>
<a href="#" class="badge bg-success">Success</a>
<a href="#" class="badge bg-danger">Danger</a>
<a href="#" class="badge bg-warning">Warning</a>