在 GitHub 上查看

徽章

徽章（我们的小计数和标签组件）的文档和示例。

示例

徽章通过使用相对字体大小和 em 单位来缩放以匹配其父元素的大小。

示例标题 新

示例标题 新

示例标题 新

示例标题 新

示例标题 新
示例标题 新
<h1>Example heading <span class="badge badge-secondary">New</span></h1>
<h2>Example heading <span class="badge badge-secondary">New</span></h2>
<h3>Example heading <span class="badge badge-secondary">New</span></h3>
<h4>Example heading <span class="badge badge-secondary">New</span></h4>
<h5>Example heading <span class="badge badge-secondary">New</span></h5>
<h6>Example heading <span class="badge badge-secondary">New</span></h6>

徽章可用作链接或按钮的一部分来提供计数。

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

请注意，根据徽章的使用方式，它们可能会让屏幕阅读器和类似辅助技术的用户感到困惑。虽然徽章的样式提供了视觉提示，但这些用户只会看到徽章的内容。根据具体情况，这些徽章可能看起来像是句子、链接或按钮末尾的随机附加单词或数字。

除非上下文很明确（如“通知”示例，其中“4”表示通知数量），请考虑使用附加文本的视觉隐藏部分来包含其他上下文。

<button type="button" class="btn btn-primary">
  Profile <span class="badge badge-light">9</span>
  <span class="sr-only">unread messages</span>
</button>

上下文变体

添加以下任何提及的修饰符类以更改徽章的外观。

主要 次要 成功 危险 警告 信息 浅色 深色 
<span class="badge badge-primary">Primary</span>
<span class="badge badge-secondary">Secondary</span>
<span class="badge badge-success">Success</span>
<span class="badge badge-danger">Danger</span>
<span class="badge badge-warning">Warning</span>
<span class="badge badge-info">Info</span>
<span class="badge badge-light">Light</span>
<span class="badge badge-dark">Dark</span>
向辅助技术传达含义

仅使用颜色添加含义只会提供视觉指示，而不会传达给辅助技术（例如屏幕阅读器）的用户。确保由颜色表示的信息要么从内容本身（例如可见文本）中很明显，要么通过其他方式包含，例如使用 .sr-only 类隐藏的附加文本。

药丸徽章

使用 .badge-pill 修饰符类使徽章更圆（具有更大的 border-radius 和额外的水平 padding）。如果你错过了 v3 中的徽章，这很有用。

主要 次要 成功 危险 警告 信息 浅色 深色 
<span class="badge badge-pill badge-primary">Primary</span>
<span class="badge badge-pill badge-secondary">Secondary</span>
<span class="badge badge-pill badge-success">Success</span>
<span class="badge badge-pill badge-danger">Danger</span>
<span class="badge badge-pill badge-warning">Warning</span>
<span class="badge badge-pill badge-info">Info</span>
<span class="badge badge-pill badge-light">Light</span>
<span class="badge badge-pill badge-dark">Dark</span>

在 <a> 元素上使用上下文 .badge-* 类可快速提供具有悬停和焦点状态的可操作徽章。

主要 次要 成功 危险 警告 信息 浅色 深色 
<a href="#" class="badge badge-primary">Primary</a>
<a href="#" class="badge badge-secondary">Secondary</a>
<a href="#" class="badge badge-success">Success</a>
<a href="#" class="badge badge-danger">Danger</a>
<a href="#" class="badge badge-warning">Warning</a>
<a href="#" class="badge badge-info">Info</a>
<a href="#" class="badge badge-light">Light</a>
<a href="#" class="badge badge-dark">Dark</a>