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-motionthe 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
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.
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.
HTML
<div class="spinner-grow" role="status">
<span class="visually-hidden">Loading...</span>
</div>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
HTML
<div class="spinner-border m-5" role="status">
<span class="visually-hidden">Loading...</span>
</div>Flex
HTML
<div class="d-flex justify-content-center">
<div class="spinner-border" role="status">
<span class="visually-hidden">Loading...</span>
</div>
</div>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
HTML
<div class="clearfix">
<div class="spinner-border float-end" role="status">
<span class="visually-hidden">Loading...</span>
</div>
</div>Text align
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.
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.
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:
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>