BootstrapVue Buttons

Use BootstrapVue buttons and BootstrapVue custom styles for actions in forms, dialogues, and more with support for multiple sizes, states, and more.


Classes

Bootstrap provides different styles of buttons:

  • .btn
  • .btn-default
  • .btn-primary
  • .btn-success
  • .btn-info
  • .btn-warning
  • .btn-danger
  • .btn-link
  • .btn-outline-default
  • .btn-outline-primary
  • .btn-outline-success
  • .btn-outline-info
  • .btn-outline-warning
  • .btn-outline-danger

Examples

Bootstrap includes several predefined button styles, each serving its own semantic purpose, with a few extras thrown in for more control.

<base-button icon type="primary">Button</base-button>

<base-button icon type="primary">
	<span class="btn-inner--icon"><i class="ni ni-bag-17"></i></span>
	<span class="btn-inner--text">With icon</span>
</base-button>

<base-button icon type="primary">
	<span class="btn-inner--icon"><i class="ni ni-atom"></i></span>
</base-button>

<base-button type="default">Default</base-button>
<base-button type="primary">Primary</base-button>
<base-button type="secondary">Secondary</base-button>
<base-button type="info">Info</base-button>
<base-button type="success">Success</base-button>
<base-button type="danger">Danger</base-button>
<base-button type="warning">Warning</base-button>

Outline buttons

In need of a button, but not the hefty background colors they bring? Replace the default modifier classes with the .btn-outline-* ones to remove all background images and colors on any button.

<base-button outline type="default">Default</base-button>
<base-button outline type="primary">Primary</base-button>
<base-button outline type="secondary">Secondary</base-button>
<base-button outline type="info">Info</base-button>
<base-button outline type="success">Success</base-button>
<base-button outline type="danger">Danger</base-button>
<base-button outline type="warning">Warning</base-button>

Sizes

Fancy larger or smaller buttons? Add .btn-lg or .btn-sm for additional sizes.

<base-button size="lg" type="primary">Large button</base-button>
<base-button size="lg" type="secondary">Large button</base-button>

<base-button size="sm" type="primary">Small button</base-button>
<base-button size="sm" type="secondary">Small button</base-button>

Create block level buttons—those that span the full width of a parent—by adding .btn-block.

<base-button block type="primary">Block level button</base-button>
<base-button block type="secondary">Block level button</base-button>

Active state

Buttons will appear pressed (with a darker background, darker border, and inset shadow) when active. There’s no need to add a class to <button>s as they use a pseudo-class. However, you can still force the same active appearance with .active (and include the aria-pressed="true" attribute) should you need to replicate the state programmatically.

Primary link Link

<base-button type="primary" class="active" aria-pressed="true">Primary link</base-button>
<base-button type="secondary" class="active" aria-pressed="true">Link</base-button>

Disabled state

Make buttons look inactive by adding the disabled boolean attribute to any <button> element.

<b-button disabled size="lg" variant="primary">Primary button</b-button>
<b-button disabled size="lg" variant="secondary">Button</b-button>

BaseButton Props

PROP NAME TYPE DEFAULT DESCRIPTION
tag String button Button html tag
round Boolean N/A  
icon Boolean N/A  
block Boolean N/A  
loading Boolean N/A  
wide Boolean N/A  
disabled Boolean N/A  
type String default Button type (primary/secondary/danger etc)
nativeType String button Button native type (e.g button, input etc)
size String N/A Button size (sm/lg)
outline Boolean N/A Whether button is outlined (only border has color)
link Boolean N/A Whether button is a link (no borders or background)

BaseButton Slots

SLOT DESCRIPTION
default Default content for the badge

BaseButton events

NAME DESCRIPTION PARAMS
click Button click event (evt) browser event

ButtonCheckbox Props

PROP NAME TYPE DEFAULT DESCRIPTION
value Boolean N/A Checked value
buttonClasses String / Object N/A Inner button css classes

ButtonCheckbox Slots

PROP NAME TYPE
default Default content for the badge

ButtonRadioGroup Props

PROP NAME TYPE DEFAULT DESCRIPTION
options Array [] Radio options. Should be an array of objects {value: “”, label: “”}
value String N/A Radio value
buttonClasses String / Object N/A Inner button css classes

If you want to see more examples and properties please check the official BootstrapVue Documentation.