Значкі

Дакументацыя і прыклады значкоў, наш невялікі кампанент падліку і маркіроўкі.

На гэтай старонцы

Прыклады

Значкі маштабуюцца ў адпаведнасці з памерам непасрэдна бацькоўскага элемента з выкарыстаннем адноснага памеру шрыфта і 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;