Badges

Dokumentation og eksempler til badges, vores lille tæller og mærkningskomponent.

På denne side

Eksempler

Badges skaleres til at matche størrelsen af det umiddelbare overordnede element ved at bruge relativ skriftstørrelse og emenheder. Fra v5 har badges ikke længere fokus eller svævestile til links.

Overskrifter

Eksempel overskriftNy

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>

Knapper

Badges kan bruges som en del af links eller knapper til at give en tæller.

html

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

Bemærk, at afhængigt af hvordan de bruges, kan badges være forvirrende for brugere af skærmlæsere og lignende hjælpeteknologier. Mens stylingen af badges giver et visuelt fingerpeg om deres formål, vil disse brugere blot blive præsenteret for indholdet af badget. Afhængigt af den specifikke situation kan disse badges virke som tilfældige ekstra ord eller tal i slutningen af en sætning, et link eller en knap.

Medmindre konteksten er klar (som med eksemplet "Notifikationer", hvor det forstås, at "4" er antallet af notifikationer), skal du overveje at inkludere yderligere kontekst med et visuelt skjult stykke ekstra tekst.

Placeret

Brug hjælpeprogrammer til at ændre en .badgeog placere den i hjørnet af et link eller en knap.

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>

Du kan også erstatte .badgeklassen med et par flere hjælpeprogrammer uden at tælle en mere generisk indikator.

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>

Baggrundsfarver

Tilføjet i v5.2.0

Sæt en background-colorkontrastfuld forgrund colormed vores .text-bg-{color}hjælpere . Tidligere var det påkrævet manuelt at parre dit valg af .text-{color}og .bg-{color}værktøjer til styling, som du stadig kan bruge, hvis du foretrækker det.

Primær Sekundær Succes Fare Advarsel Info Lys Mørk

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>

Formidle mening til hjælpeteknologier

Brug af farve til at tilføje betydning giver kun en visuel indikation, som ikke vil blive formidlet til brugere af hjælpeteknologier - såsom skærmlæsere. Sørg for, at oplysninger, der er angivet med farven, enten er tydelige fra selve indholdet (f.eks. den synlige tekst), eller er inkluderet via alternative måder, såsom ekstra tekst skjult i .visually-hiddenklassen.

Pillemærker

Brug .rounded-pillhjælpeklassen til at gøre badges mere afrundede med en større border-radius.

Primær Sekundær Succes Fare Advarsel Info Lys Mørk

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

Variabler

Tilføjet i v5.2.0

Som en del af Bootstraps udviklende CSS-variabletilgang bruger badges nu lokale CSS-variabler .badgetil forbedret realtidstilpasning. Værdier for CSS-variablerne indstilles via Sass, så Sass-tilpasning understøttes også stadig.

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

Sass variable

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