バッジ

小さなカウントとラベリングコンポーネントであるバッジのドキュメントと例。

このページでは

例

バッジは、相対的なフォントサイズとem単位を使用して、直接の親要素のサイズに合わせてスケーリングされます。v5 の時点で、バッジにはリンクのフォーカスまたはホバースタイルがなくなりました。

見出し

見出しの例新しい

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 変数アプローチの一環として、.badgeリアルタイムのカスタマイズを強化するためにバッジでローカル CSS 変数が使用されるようになりました。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};

サス変数

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