Odznaki

Dokumentacja i przykłady odznak, nasz składnik małej liczby i etykietowania.

Na tej stronie

Przykłady

Plakietki są skalowane w celu dopasowania do rozmiaru bezpośredniego elementu nadrzędnego przy użyciu względnego rozmiaru czcionki i emjednostek. Od wersji 5 odznaki nie mają już stylów fokusu ani najechania na linki.

Nagłówki

Przykładowy nagłówekNowy

html

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

guziki

Odznaki mogą być używane jako część linków lub przycisków, aby zapewnić licznik.

html

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

Pamiętaj, że w zależności od sposobu ich użycia plakietki mogą być mylące dla użytkowników czytników ekranu i podobnych technologii wspomagających. Podczas gdy stylizacja odznak zapewnia wizualną wskazówkę co do ich przeznaczenia, użytkownicy ci będą po prostu prezentowani z zawartością odznaki. W zależności od konkretnej sytuacji plakietki te mogą wyglądać jak przypadkowe dodatkowe słowa lub cyfry na końcu zdania, linku lub przycisku.

O ile kontekst nie jest jasny (jak w przykładzie „Powiadomienia”, gdzie rozumie się, że „4” to liczba powiadomień), rozważ dołączenie dodatkowego kontekstu z wizualnie ukrytym fragmentem dodatkowego tekstu.

Umieszczony

Użyj narzędzi do modyfikacji .badgei umieść go w rogu łącza lub przycisku.

html

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

Możesz również zastąpić .badgeklasę kilkoma dodatkowymi narzędziami bez liczenia dla bardziej ogólnego wskaźnika.

html

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

Kolory tła

Dodano w wersji 5.2.0

Ustaw background-colorkontrast na pierwszym planie colorz naszymi .text-bg-{color}pomocnikami . Wcześniej konieczne było ręczne sparowanie wybranych narzędzi .text-{color}i .bg-{color}narzędzi do stylizacji, z których nadal możesz korzystać, jeśli wolisz.

Podstawowy Wtórny Powodzenie Zagrożenie Ostrzeżenie Informacje Światło Ciemny

html

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

Nadawanie znaczenia technologiom wspomagającym

Użycie koloru w celu dodania znaczenia zapewnia jedynie wizualne wskazanie, które nie zostanie przekazane użytkownikom technologii wspomagających – takich jak czytniki ekranu. Upewnij się, że informacje oznaczone kolorem są oczywiste z samej treści (np. widoczny tekst) lub są zawarte w inny sposób, np. dodatkowy tekst ukryty z .visually-hiddenklasą.

Odznaki pigułki

Użyj .rounded-pillklasy użytkowej, aby odznaki były bardziej zaokrąglone z większym border-radius.

Podstawowy Wtórny Powodzenie Zagrożenie Ostrzeżenie Informacje Światło Ciemny

html

<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

Zmienne

Dodano w wersji 5.2.0

W ramach ewoluującego podejścia Bootstrap do zmiennych CSS, odznaki używają teraz lokalnych zmiennych CSS, .badgeaby usprawnić dostosowywanie w czasie rzeczywistym. Wartości zmiennych CSS są ustawiane przez Sass, więc dostosowywanie Sass jest nadal obsługiwane.

  --#{$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};

Zmienne Sassa

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