Spinners

Indicate the loading state of a component or page with Bootstrap spinners, built entirely with HTML, CSS, and no JavaScript.

On this page

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
    button="primary"
    disabled
  >
    <Spinner
      sm
      aria-hidden="true"
    />
  </b-button>
  <b-button
    button="primary"
    disabled
  >
    <Spinner
      sm
      aria-hidden="true"
    />
    Loading...
  </b-button>
</template>

vue

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