Значки

Документация и примери за значки, нашия малък компонент за броене и етикетиране.

На тази страница

Примери

Значките се мащабират, за да съответстват на размера на непосредствения родителски елемент, като използват относителен размер на шрифта и emединици. От версия 5 значките вече нямат стилове за фокусиране или задържане на мишката за връзки.

Заглавия

Примерно заглавиеНов

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>

Бутони

Значките могат да се използват като част от връзки или бутони за осигуряване на брояч.

html

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

Имайте предвид, че в зависимост от това как се използват, значките може да са объркващи за потребителите на екранни четци и подобни помощни технологии. Въпреки че стилът на значките предоставя визуален знак за тяхната цел, на тези потребители просто ще бъде представено съдържанието на значката. В зависимост от конкретната ситуация, тези значки може да изглеждат като произволни допълнителни думи или цифри в края на изречение, връзка или бутон.

Освен ако контекстът не е ясен (както при примера „Известия“, където се разбира, че „4“ е броят на известията), помислете за включване на допълнителен контекст с визуално скрит допълнителен текст.

Позициониран

Използвайте помощни програми, за да промените .badgeи позиционирате в ъгъла на връзка или бутон.

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>

Можете също да замените .badgeкласа с още няколко помощни програми без преброяване за по-общ индикатор.

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>

Цветове на фона

Добавен във v5.2.0

Задайте background-colorс контрастен преден план colorс нашите .text-bg-{color}помощници . Преди се изискваше ръчно да сдвоявате вашите избори .text-{color}и .bg-{color}помощни програми за оформяне, които все още можете да използвате, ако предпочитате.

Първичен Втори Успех опасност Внимание Информация Светлина Тъмно

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>

Предаване на значение на помощните технологии

Използването на цвят за добавяне на смисъл осигурява само визуална индикация, която няма да бъде предадена на потребителите на помощни технологии – като екранни четци. Уверете се, че информацията, обозначена с цвета, е или очевидна от самото съдържание (напр. видимия текст), или е включена чрез алтернативни средства, като например допълнителен текст, скрит с .visually-hiddenкласа.

Значки за хапчета

Използвайте .rounded-pillпомощния клас, за да направите значките по-заоблени с по-голям border-radius.

Първичен Втори Успех опасност Внимание Информация Светлина Тъмно

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

Променливи

Добавен във v5.2.0

Като част от развиващия се подход на Bootstrap към CSS променливите, значките вече използват локални CSS променливи .badgeза подобрено персонализиране в реално време. Стойностите за CSS променливите се задават чрез Sass, така че персонализирането на Sass все още се поддържа.

  --#{$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 променливи

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