Spinners

About

Their appearance, alignment, and sizing can be easily customized with our amazing utility classes.

Border spinne

Use the border spinners for a lightweight loading indicator.

vue

<template>
 <Spinner />
</template>

Colors

The border spinner uses text-color attribute for its Spinner component, meaning you can customize the color with text color utilities .

You can use any of our text color utilities on the standard spinner.

vue

<template>
 <Spinner text-color="primary" />
 <Spinner text-color="secondary" />
 <Spinner text-color="success" />
 <Spinner text-color="danger" />
 <Spinner text-color="warning" />
 <Spinner text-color="info" />
 <Spinner text-color="light" />
 <Spinner text-color="dark" />
</template>

Growing spinner

If you don't fancy a border spinner, switch to the grow spinner. While it doesn't technically spin, it does repeatedly grow!

vue

<template>
 <Spinner spinner="grow" />
</template>

Once again, this spinner is built with text-color, so you can easily change its appearance with [text color utilities][color]. Here it is in blue, along with the supported variants.

vue

<template>
 <Spinner
  spinner="grow"
  text-color="primary"
 />
 <Spinner
  spinner="grow"
  text-color="secondary"
 />
 <Spinner
  spinner="grow"
  text-color="success"
 />
 <Spinner
  spinner="grow"
  text-color="danger"
 />
 <Spinner
  spinner="grow"
  text-color="warning"
 />
 <Spinner
  spinner="grow"
  text-color="info"
 />
 <Spinner
  spinner="grow"
  text-color="light"
 />
 <Spinner
  spinner="grow"
  text-color="dark"
 />
</template>

Alignment

Spinners in Bootstrap are built with rems, text-color, and display: inline-flex.

This means they can easily be resized, recolored, and quickly aligned.

Margin

Use margin utilities like mergin="5" for easy spacing.

vue

<template>
 <Spinner :mergin="5" />
</template>

Placement

Use flexbox utilities , float utilites , or text alignment utilities to place spinners exactly where you need them in any situation.

Flex

vue

<template>
 <b-div
  flex
  justify-content="center"
 >
  <Spinner>
   <b-span visually-hidden>
    Loading...
   </b-span>
  </Spinner>
 </b-div>
</template>

Loading...

vue

<template>
 <b-div
  flex
  align-items="center"
 >
  <strong>Loading...</strong>
  <Spinner
   aria-hidden="true"
   margin="s-auto"
  />
 </b-div>
</template>

Floats

vue

<template>
 <b-div clearfix>
  <Spinner float="end" />
 </b-div>
</template>

Text align

vue

<template>
 <b-div text-alignment="center">
  <Spinner />
 </b-div>
</template>

Size

Add sm attribute to make a smaller spinner that can quickly be used within other components.

vue

<template>
 <Spinner sm />
 <Spinner
  spinner="grow"
  sm
 />
</template>

Or, use custom CSS or inline styles to change the dimensions as needed.

vue

<template>
 <Spinner style="width: 3rem; height: 3rem" />
 <Spinner
  spinner="grow"
  style="width: 3rem; height: 3rem"
 />
</template>

Buttons

Use spinners within buttons to indicate an action is currently processing or taking place. You may also swap the text out of the spinner element and utilize button text as needed.

vue

<template>
 <b-button
  color="primary"
  disabled
 >
  <Spinner
   sm
   aria-hidden="true"
  />
 </b-button>
 <b-button
  color="primary"
  disabled
 >
  <Spinner
   sm
   aria-hidden="true"
  />
  Loading...
 </b-button>
</template>

vue

<template>
 <b-button
  button
  color="primary"
  disabled
 >
  <Spinner
   spinner="grow"
   sm
   aria-hidden="true"
  />
 </b-button>
 <b-button
  button
  color="primary"
  disabled
 >
  <Spinner
   spinner="grow"
   sm
   aria-hidden="true"
  />
  Loading...
 </b-button>
</template>