徽章（Badge）

文件和徽章，我們的小計數和標簽組件的例子。

On this page

例子

過使用相對字體大小和em單位，徽章可以縮放以匹配直接父元素的大小。從v5開始，徽章不再具有鏈接的焦點或懸停樣式。

Example heading New

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

徽章可以作為鏈接或按鈕的一部分來提供計數器。

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

請注意，根據它們的使用方式，徽章可能會讓屏幕閱讀器和類似輔助技術的用戶感到困惑。雖然徽章的樣式提供了一個關于其用途的視覺提示，但這些用戶只需看到徽章的內容。根據具體情況，這些徽章可能看起來像是句子、鏈接或按鈕末尾的隨機附加單詞或數字。

除非上下文是清楚的（如“Notifications”示例，其中理解為“4”是通知的數量），否則請考慮將附加上下文包括在視覺上隱藏的附加文本片段中。

<button type="button" class="btn btn-primary">
Profile <span class="badge bg-secondary">9</span>
<span class="visually-hidden">unread messages</span>
</button>

背景顏色

使用我們的后臺實用程序類快速更改徽章的外觀。請注意，使用Bootstrap的默認.bg-light時，您可能需要一個文本顏色實用程序，如.text-dark，以獲得正確的樣式。這是因為背景實用程序只設置背景顏色。

Primary Secondary Success Danger Warning Info Light Dark

<span class="badge bg-primary">Primary</span>
<span class="badge bg-secondary">Secondary</span>
<span class="badge bg-success">Success</span>
<span class="badge bg-danger">Danger</span>
<span class="badge bg-warning text-dark">Warning</span>
<span class="badge bg-info text-dark">Info</span>
<span class="badge bg-light text-dark">Light</span>
<span class="badge bg-dark">Dark</span>

向輔助技術傳達意義

使用顏色來增加意義只會提供一種視覺指示，而不會傳達給輔助技術（如屏幕閱讀器）的用戶。確保由顏色表示的信息在內容本身（例如可見文本）中是明顯的，或者通過其他方式包含，例如使用.visually-hidden類隱藏的其他文本。

膠囊徽章

使用.rounded-pill實用程序類使徽章更圓，邊界半徑更大。

Primary Secondary Success Danger Warning Info Light Dark

<span class="badge rounded-pill bg-primary">Primary</span>
<span class="badge rounded-pill bg-secondary">Secondary</span>
<span class="badge rounded-pill bg-success">Success</span>
<span class="badge rounded-pill bg-danger">Danger</span>
<span class="badge rounded-pill bg-warning text-dark">Warning</span>
<span class="badge rounded-pill bg-info text-dark">Info</span>
<span class="badge rounded-pill bg-light text-dark">Light</span>
<span class="badge rounded-pill bg-dark">Dark</span>

Sass

Variables

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