Кнопка

Используйте специальный компонент Bootstrap b-button для действий в формах, диалоговых окнах и т. д. Включает поддержку нескольких контекстных вариаций, размеров, состояний и т. д.

Справочник по компонентам

Псевдонимы компонентов

<b-button> также может использоваться через следующие псевдонимы:

  • <b-btn>

Примечание: Псевдонимы компонентов доступны только при импорте всего BootstrapVue или при использовании подключаемого модуля группы компонентов.

Свойства

Все значения свойств по умолчанию настраиваются глобально.

Свойство
(Click to sort ascending)
Тип
(Click to sort ascending)
По умолчанию
Описание
active
BooleanfalseПри значении `true` переводит компонент в активное состояние с активным стилем.
active-class
String<router-link> свойство: Настройка активного класса CSS, применяемого, когда ссылка активна. Обычно Вам нужно установить это имя класса 'active'
append
Booleanfalse<router-link> свойство: Настройка добавления свойства всегда добавляет относительный путь к текущему пути
block
BooleanfalseОтображает кнопку шириной 100% (расширяется до ширины родительского контейнера)
disabled
BooleanfalseЕсли установлено значение `true`, отключает функциональность компонента и переводит его в отключенное состояние.
exact
Booleanfalse<router-link> свойство: Поведение сопоставления активного класса по умолчанию включает сопоставление. Установка этого свойства заставляет режим точно соответствовать маршруту
exact-active-class
String<router-link> свойство: Настройка активного класса CSS, применяемого, когда ссылка активна с точным соответствием. Обычно Вам нужно установить это имя класса 'active'
exact-path
Booleanfalse<router-link> prop: Allows matching only using the path section of the url, effectively ignoring the query and the hash sections
exact-path-active-class
String<router-link> prop: Configure the active CSS class applied when the link is active with exact path match. Typically you will want to set this to class name 'active'
href
String<b-link> свойство: Обозначает целевой URL-адрес ссылки для стандартных ссылок
no-prefetch
Booleanfalse<nuxt-link> свойство: Чтобы улучшить отзывчивость Ваших приложений Nuxt.js, когда ссылка будет отображаться в области просмотра, Nuxt.js автоматически выполнит предварительную загрузку страницы с разделением кода. Установка `no-prefetch` отключит эту функцию для конкретной ссылки
pill
BooleanfalseОтображает кнопку в стиле таблетки, если задано значение 'true'
prefetch
v2.15.0+
Booleannull<nuxt-link> свойство: Чтобы улучшить отзывчивость Ваших приложений Nuxt.js, когда ссылка будет отображаться в области просмотра, Nuxt.js автоматически выполнит предварительную загрузку страницы с разделением кода. Установка для `prefetch` значения `true` или `false` перезапишет значение по умолчанию `router.prefetchLinks`
pressed
BooleannullЕсли установлено значение 'true', придает кнопке вид нажатой и добавляет атрибут 'aria-pressed="true"'. Если установлено значение `false`, добавляет атрибут 'aria-pressed="false"'. Свойство трех состояний. Синхронизируется с модификатором .sync
rel
Stringnull<b-link> свойство: Устанавливает атрибут `rel` для отображаемой ссылки
replace
Booleanfalse<router-link> свойство: Установка свойства `replace` будет вызывать `router.replace()` вместо `router.push()` при нажатии, поэтому навигация не будет оставлять запись в истории
router-component-name
v2.15.0+
String<b-link> свойство: BootstrapVue автоматически определяет между `<router-link>` и `<nuxt-link>`. В случаях, когда Вы хотите использовать сторонний компонент ссылки на основе `<router-link>`, установите это свойство на имя компонента, например установите для него значение 'g-link', если Вы используете Gridsome (обратите внимание, что компоненту передаются только определенные свойства `<router-link>`)
size
StringУстановите размер внешнего вида компонента. 'sm', 'md' (по умолчанию) или 'lg'
squared
BooleanfalseОтображает кнопку с нескругленными углами, если установлено значение 'true'
tag
String'button'Указывает тег HTML для отображения вместо тега по умолчанию
target
String'_self'<b-link> свойство: Устанавливает атрибут `target` для отображаемой ссылки
to
Object или String<router-link> свойство: Обозначает целевой маршрут ссылки. При нажатии значение свойства будет передано в `router.push()` внутренне, поэтому значение может быть либо строкой, либо объектом дескриптора местоположения
type
String'button'Значение, которое нужно установить для атрибута кнопки 'type'. Может быть одним из 'button', 'submit' или 'reset'
variant
String'secondary'Применяет к компоненту один из вариантов цвета темы Bootstrap

<b-button> поддерживает генерацию <router-link> или <nuxt-link> компонент (при использовании Nuxt.js). Дополнительные сведения о свойствах, связанных с ссылками на маршрутизаторы (или Nuxt Link), смотрите в разделе справки по поддержке роутов.

Слоты

Наименование
Описание
default Контент для размещения на кнопке

События

Событие
Аргументы
Описание
click
  1. Нативный объект события клика
Генерируется при нажатии неотключенной кнопки

Псевдонимы компонентов

<b-button-close> также может использоваться через следующие псевдонимы:

  • <b-btn-close>

Примечание: Псевдонимы компонентов доступны только при импорте всего BootstrapVue или при использовании подключаемого модуля группы компонентов.

Свойства

Все значения свойств по умолчанию настраиваются глобально.

Свойство
Тип
По умолчанию
Описание
aria-label
String'Close'Устанавливает значение атрибута 'aria-label' для визуализированного элемента
content
v2.3.0+
String'&times;'Содержание кнопки закрытия
disabled
BooleanfalseЕсли установлено значение `true`, отключает функциональность компонента и переводит его в отключенное состояние.
text-variant
StringПрименяет к тексту один из вариантов цвета темы Bootstrap

Слоты

Наименование
Описание
default Контент для размещения на кнопке. Переопределяет свойство `content`

События

Событие
Аргументы
Описание
click
  1. Нативный объект события клика
Генерируется при нажатии неотключенной кнопки

Импорт отдельных компонентов

Вы можете импортировать отдельные компоненты в свой проект с помощью следующих именованных экспортов:

Компонент
Именованный экспорт
Путь импорта
<b-button>BButtonbootstrap-vue
<b-button-close>BButtonClosebootstrap-vue

Пример:

import { BButton } from 'bootstrap-vue'
Vue.component('b-button', BButton)

Импортировать как плагин Vue.js

Этот плагин включает в себя все перечисленные выше отдельные компоненты. Плагины также включают псевдонимы любых компонентов.

Именованный экспорт
Путь импорта
ButtonPluginbootstrap-vue

Пример:

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