GitHubで見る

バッジ

Badges

バッジについての概要と使い方の例です。

項目

例

親要素のサイズに一致するように相対的なフォントサイズemを使用しています。
v5 以降、バッジにはリンクのフォーカススタイルやホバースタイルがありません。

見出し

Example heading New

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>

背景色

Added in v5.2.0

.text-bg-{color}ヘルパーを使って、background-colorと対照的な前景色colorを設定できます。以前は、スタイリングのために.text-{color}と.bg-{color}ユーティリティを選択し手動で組み合わせる必要がありましたが、今でもお好みで使うことができます。

Primary Secondary Success Danger Warning Info Light Dark

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を持つことで、より丸くすることができます。

Primary Secondary Success Danger Warning Info Light Dark

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

変数

Added in 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);