徽章

微小的、适应性的标签,可为几乎所有内容添加上下文。

概览

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

<div>
  <h2>Example heading <b-badge>New</b-badge></h2>
  <h3>Example heading <b-badge>New</b-badge></h3>
  <h4>Example heading <b-badge>New</b-badge></h4>
  <h5>Example heading <b-badge>New</b-badge></h5>
  <h6>Example heading <b-badge>New</b-badge></h6>
</div>

<!-- b-badges.vue -->

徽章可作为链接或按钮的一部分,以提供计数(或类似标记)。

<div class="text-center">
  <b-button variant="primary">
    Notifications <b-badge variant="light">4</b-badge>
  </b-button>
</div>

<!-- b-badge-button.vue -->

请注意,根据徽章的使用方式,它们可能令屏幕阅读器和其他类似辅助技术的用户感到困惑。尽管徽章的样式会以视觉提示表明其目的,但这些用户只会看到徽章的内容。具体取决于相应的情况,这些徽章可能看起来像是句末、链接末尾或按钮末尾的随机附加单词或数字。

除非上下文很明显(如“通知”示例中,“4”被理解为通知的数目),否则请考虑使用额外的隐藏文本来提供其他上下文信息。

<div class="text-center">
  <b-button variant="primary">
    Profile
    <b-badge variant="light">9 <span class="sr-only">unread messages</span></b-badge>
  </b-button>
</div>

<!-- b-badge-button-aria.vue -->

上下文变体

通过 variant prop 添加以下任何一个变体,可更改 <b-badge> 的外观:defaultprimarysuccesswarninginfo 以及 danger。如果未指定变体,则会使用 default

<div>
  <b-badge variant="primary">Primary</b-badge>
  <b-badge variant="secondary">Secondary</b-badge>
  <b-badge variant="success">Success</b-badge>
  <b-badge variant="danger">Danger</b-badge>
  <b-badge variant="warning">Warning</b-badge>
  <b-badge variant="info">Info</b-badge>
  <b-badge variant="light">Light</b-badge>
  <b-badge variant="dark">Dark</b-badge>
</div>

<!-- b-badge-variants.vue -->

传达辅助技术含义

仅使用颜色添加含义只能提供视觉提示,而这无法传达给辅助技术(如屏幕阅读器)的用户。请确保由颜色表示的信息从内容本身(例如,可见文本)中即可得知,或通过其他方式(例如,使用 .sr-only 类隐藏的附加文本)包含其中。

藥丸徽章

使用 pill 屬性讓徽章更圓(較大的邊框半徑和額外的水平填充)。如果想念 Bootstrap v3 的徽章,此功能便有所助益。

<div>
  <b-badge pill variant="primary">Primary</b-badge>
  <b-badge pill variant="secondary">Secondary</b-badge>
  <b-badge pill variant="success">Success</b-badge>
  <b-badge pill variant="danger">Danger</b-badge>
  <b-badge pill variant="warning">Warning</b-badge>
  <b-badge pill variant="info">Info</b-badge>
  <b-badge pill variant="light">Light</b-badge>
  <b-badge pill variant="dark">Dark</b-badge>
</div>

<!-- b-badge-pill.vue -->

可操作的徽章

同時指定 href 屬性(連結)或 to 屬性(路由器連結)可快速提供可操作的徽章,並有滑鼠懸停及焦點狀態。

<div>
  <b-badge href="#" variant="primary">Primary</b-badge>
  <b-badge href="#" variant="secondary">Secondary</b-badge>
  <b-badge href="#" variant="success">Success</b-badge>
  <b-badge href="#" variant="danger">Danger</b-badge>
  <b-badge href="#" variant="warning">Warning</b-badge>
  <b-badge href="#" variant="info">Info</b-badge>
  <b-badge href="#" variant="light">Light</b-badge>
  <b-badge href="#" variant="dark">Dark</b-badge>
</div>

<!-- b-badge-action.vue -->

請參考 路由器支援 參考頁面,以取得連結器特定屬性的相關資訊。

元件參考

<b-badge>

功能性元件

屬性

所有屬性預設值都可以 全球設定

屬性
(按一下以升冪排序)
類別
(按一下以升冪排序)
預設值
描述
active
布林值false設為 `true` 時,會以 active 樣式將元件設定為 active 狀態
active-class
字串<router-link> 屬性:當連結處於 active 狀態時,設定套用的 active CSS 類別。您通常會想將它設定為類別名稱「active」
append
布林值false<router-link> 屬性:設定 append 屬性會將相對路徑永遠附加至目前的相對路徑
disabled
布林值false設為 `true` 時,會停用元件的功能並將它設為停用狀態
exact
布林值false<router-link> 屬性:預設 active 類別比對行為是包含比對。設定此屬性會強制模式確實比對路線
exact-active-class
字串<router-link> 屬性:設定在連結處於 active 狀態、並有確實比對時,套用的 active CSS 類別。您通常會想將它設定為類別名稱「active」
exact-path
布林值false<router-link> 屬性:允許只使用 URL 的路徑區段來比對,實際上會忽略查詢和 hash 區段
exact-path-active-class
字串<router-link> 屬性:設定在連結處於 active 狀態、並有確實路徑比對時,套用的 active CSS 類別。您通常會想將它設定為類別名稱「active」
href
字串<b-link> 屬性:表示標準 a 連結的目標 URL
no-prefetch
布林值false<nuxt-link> 屬性:為了改善 Nuxt.js 程式的回應性,當連結會顯示在視窗中時,Nuxt.js 會自動預先擷取代碼分頁。設定 `no-prefetch` 將會停用特定連結的此功能
pill
布林值false設為「true」時,會以藥丸樣式呈現徽章
prefetch
v2.15.0+
布林值null<nuxt-link> 屬性:為了改善 Nuxt.js 程式的回應性,當連結會顯示在視窗中時,Nuxt.js 會自動預先擷取代碼分頁。將 `prefetch` 設定為 `true` 或 `false` 時,會覆寫 `router.prefetchLinks` 預設值
rel
字串null<b-link> 屬性:設定呈現的連結上 `rel` 屬性
replace
布林值false<router-link> 屬性:設定 replace 屬性時,按一下時會呼叫 `router.replace()` 而非 `router.push()`,因此導覽不會留下記錄
router-component-name
v2.15.0+
字串屬性:BootstrapVue 自動偵測 <router-link> 和 <nuxt-link>。在你要使用一基於 <router-link> 的第三方連結元件時,將此屬性設定為元件名稱。例如如果你使用 Gridsome,請將其設定為 'g-link'(請注意,只有特定於 <router-link> 的屬性才會傳遞給元件)
標籤
字串'span'指定要呈現的 HTML 標籤以替代預設標籤
目標 (target)
字串'_self'屬性:設定呈現的連結上的 `target` 屬性
前往 (to)
物件或字串屬性:表示連結的目標路由。當被點選時,`to` 屬性的值會被傳遞給 `router.push()`,所以值可以是字串或位置描述物件
變體
字串'secondary'將其中一組 Bootstrap 主題色彩變體套用在元件上

屬性:<b-badge> 支援產生 <router-link> 或 <nuxt-link> 元件(如果你使用 Nuxt.js 的話)。關於連結的更多詳細資訊(或 nuxt 連結)特定屬性,請參閱 路由支援 參考區段。

區段

名稱
描述
預設 要放入徽章中的內容

匯入個別元件

你可以透過以下的命名匯出將個別元件匯入專案中

元件
命名匯出
匯入路徑
<b-badge>BBadgebootstrap-vue

範例

import { BBadge } from 'bootstrap-vue'
Vue.component('b-badge', BBadge)

以 Vue.js 外掛方式匯入

此外掛包含上面列出的所有個別元件外掛也會包含任何元件別名。

命名匯出
匯入路徑
BadgePluginbootstrap-vue

範例

import { BadgePlugin } from 'bootstrap-vue'
Vue.use(BadgePlugin)