徽章

徽章的文档与实例,包含小号及元件.

实例

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

Example heading New
Example heading New
Example heading New
Example heading New
Example heading New
Example heading New
<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>

情境变化

加入以下的 Class 来修改徽章的外观。

Primary Secondary Success Danger Warning Info Light Dark
<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)。

Primary Secondary Success Danger Warning Info Light Dark
<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>

使用 .badge-* 可在 <a> 元素上调整 hover 和 focus 的效果。

Primary Secondary Success Danger Warning Info Light Dark
<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>