メインコンテンツにスキップ ドキュメントナビゲーションにスキップ
GitHubで表示

バッジ

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

このページの内容

例

バッジは、相対的なフォントサイズと em 単位を使用することにより、直接の親要素のサイズに合わせて拡大縮小します。 v5以降、バッジはリンクのフォーカスまたはホバースタイルを持ちません。

見出し

見出しの例 新着

見出しの例 新着

見出しの例 新着

見出しの例 新着

見出しの例 新着
見出しの例 新着
html 
<h1>Example heading <span class="badge text-bg-secondary">New</span></h1>
<h2>Example heading <span class="badge text-bg-secondary">New</span></h2>
<h3>Example heading <span class="badge text-bg-secondary">New</span></h3>
<h4>Example heading <span class="badge text-bg-secondary">New</span></h4>
<h5>Example heading <span class="badge text-bg-secondary">New</span></h5>
<h6>Example heading <span class="badge text-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で追加

.text-bg-{color} ヘルパーを使用して、コントラストのある前景色を持つ background-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のカスタマイズも引き続きサポートされています。

scss/_badge.scss 
--#{$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変数

scss/_variables.scss 
$badge-font-size:                   .75em;
$badge-font-weight:                 $font-weight-bold;
$badge-color:                       $white;
$badge-padding-y:                   .35em;
$badge-padding-x:                   .65em;
$badge-border-radius:               var(--#{$prefix}border-radius);