Spinner
Spinner
Full documentation: https://webawesome.com/docs/components/spinner
<wa-spinner> Stable Since 2.0
Spinners indicate that an operation is in progress when the duration is unknown. Use them for loading states where a determinate progress bar isn’t practical.
<wa-spinner></wa-spinner>
Examples
Size
Spinners are sized based on the current font size. To change their size, set the font-size property on the spinner itself or on a parent element as shown below.
<wa-spinner></wa-spinner>
<wa-spinner style="font-size: 2rem;"></wa-spinner>
<wa-spinner style="font-size: 3rem;"></wa-spinner>
Track Width
The width of the spinner’s track can be changed by setting the --track-width custom property.
<wa-spinner style="font-size: 50px; --track-width: 10px;"></wa-spinner>
Color
The spinner’s colors can be changed by setting the --indicator-color and --track-color custom properties.
<wa-spinner style="font-size: 3rem; --indicator-color: deeppink; --track-color: pink;"></wa-spinner>
Importing
If you’re using the autoloader or a hosted project, components load on demand — no manual import needed. To cherry-pick a component manually, use one of the following snippets.
**CDN**
Import this component directly from the CDN:
import 'https://ka-f.webawesome.com/webawesome@3.7.0/components/spinner/spinner.js';
**npm**
After installing Web Awesome via npm, import this component:
import '@awesome.me/webawesome/dist/components/spinner/spinner.js';
**Self-Hosted**
If you’re self-hosting Web Awesome, import this component from your server:
import './webawesome/dist/components/spinner/spinner.js';
**React**
To import this component for React 18 or below, use the following code:
import WaSpinner from '@awesome.me/webawesome/dist/react/spinner/index.js';
Attributes & Properties
Learn more about attributes and properties.
| Name | Description | Reflects | |
|---|---|---|---|
| `css` | `CSSResultGroup \| undefined` One or more CSSResultGroup to include in the component’s shadow root. Host styles are automatically prepended. Type Default styles |
CSS custom properties
Learn more about CSS custom properties.
| Name | Description |
|---|---|
| `–indicator-color` | The color of the spinner’s indicator. |
| `–speed` | The time it takes for the spinner to complete one animation cycle. |
| `–track-color` | The color of the track. |
| `–track-width` | The width of the track. |
CSS parts
Learn more about CSS parts.
| Name | Description | CSS selector |
|---|---|---|
| `base` | The component’s base wrapper. | `::part(base)` |
Need a hand? Report a bug Ask for help