Skip to main content

Components

Spinners

Loading indicators drawn with borders and CSS animation — no images, no script.

How it works

A spinner is a single element. .spinner-border draws a ring with one transparent side and rotates it; .spinner-grow scales a dot up while fading it in. Both are CSS @keyframes and both use currentcolor, so a text colour utility is all it takes to recolour one. Showing and hiding a spinner is markup — render it when something is loading.

  • Baseline: CSS animation. Works everywhere.
  • Enhancement: none needed.
  • Fallback: under prefers-reduced-motion the animation slows to a 1.5s cycle instead of stopping, so it still reads as "busy".

Always add role="status" and a .visually-hidden label. A spinning ring says nothing to a screen reader on its own.

Border spinner

Loading...
HTML
<div class="spinner-border" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

Colors

The ring is currentcolor. Use text colour utilities, including the brand .text-gold, .text-navy and .text-cream.

Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
HTML
<div class="spinner-border text-primary" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-secondary" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-success" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-danger" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-warning" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-info" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-light" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-dark" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-gold" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-border text-navy" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

Growing spinner

.spinner-grow pulses instead of rotating.

Loading...
HTML
<div class="spinner-grow" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
HTML
<div class="spinner-grow text-primary" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-secondary" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-success" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-danger" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-warning" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-info" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-light" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-dark" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-gold" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow text-navy" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

Alignment

Spinners are display: inline-block with vertical-align: -0.125em, so the usual utilities place them.

Margin

Loading...
HTML
<div class="spinner-border m-5" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

Flex

Loading...
HTML
<div class="d-flex justify-content-center">
  <div class="spinner-border" role="status">
    <span class="visually-hidden">Loading...</span>
  </div>
</div>
Loading the card...
HTML
<div class="d-flex align-items-center">
  <strong role="status">Loading the card...</strong>
  <div class="spinner-border ms-auto" aria-hidden="true"></div>
</div>

Floats

Loading...
HTML
<div class="clearfix">
  <div class="spinner-border float-end" role="status">
    <span class="visually-hidden">Loading...</span>
  </div>
</div>

Text align

Loading...
HTML
<div class="text-center">
  <div class="spinner-border" role="status">
    <span class="visually-hidden">Loading...</span>
  </div>
</div>

Size

.spinner-border-sm and .spinner-grow-sm give a 1rem spinner for inline use.

Loading...
Loading...
HTML
<div class="spinner-border spinner-border-sm" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow spinner-grow-sm" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

Any other size: set the --bs-spinner-width and --bs-spinner-height variables, or override width and height.

Loading...
Loading...
HTML
<div class="spinner-border" style="width: 3rem; height: 3rem;" role="status">
  <span class="visually-hidden">Loading...</span>
</div>
<div class="spinner-grow" style="width: 3rem; height: 3rem;" role="status">
  <span class="visually-hidden">Loading...</span>
</div>

Buttons

Drop a small spinner into a button, with or without text. The label on the button carries the meaning.

HTML
<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-border spinner-border-sm" aria-hidden="true"></span>
  <span class="visually-hidden" role="status">Loading...</span>
</button>
<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-border spinner-border-sm" aria-hidden="true"></span>
  <span role="status">Loading...</span>
</button>
HTML
<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-grow spinner-grow-sm" aria-hidden="true"></span>
  <span class="visually-hidden" role="status">Loading...</span>
</button>
<button class="btn btn-primary" type="button" disabled>
  <span class="spinner-grow spinner-grow-sm" aria-hidden="true"></span>
  <span role="status">Loading...</span>
</button>

CSS

Local variables on each spinner class:

.spinner-border {
  --bs-spinner-width: 2rem;
  --bs-spinner-height: 2rem;
  --bs-spinner-vertical-align: -0.125em;
  --bs-spinner-border-width: 0.25em;
  --bs-spinner-animation-speed: 0.75s;
  --bs-spinner-animation-name: spinner-border;
}

.spinner-border-sm {
  --bs-spinner-width: 1rem;
  --bs-spinner-height: 1rem;
  --bs-spinner-border-width: 0.2em;
}

.spinner-grow {
  --bs-spinner-width: 2rem;
  --bs-spinner-height: 2rem;
  --bs-spinner-vertical-align: -0.125em;
  --bs-spinner-animation-speed: 0.75s;
  --bs-spinner-animation-name: spinner-grow;
}

.spinner-grow-sm {
  --bs-spinner-width: 1rem;
  --bs-spinner-height: 1rem;
}

Slow one down or thicken the ring inline:

Loading...
HTML
<div class="spinner-border text-gold" style="--bs-spinner-animation-speed: 1.5s; --bs-spinner-border-width: 0.5em;" role="status">
  <span class="visually-hidden">Loading...</span>
</div>