Spinner

lightning-spinner

Displays an animated spinner.

For Use In

Lightning Experience, Experience Builder Sites, Salesforce Mobile App, Lightning Out (Beta), Standalone Lightning App, Mobile Offline

A lightning-spinner displays an animated spinner image to indicate that a feature is loading. This component can be used when retrieving data or anytime an operation doesn't immediately complete.

The variant attribute changes the appearance of the spinner. If you set variant="brand", the spinner matches the Lightning Design System brand color. Setting variant="inverse" displays a white spinner. The default spinner color is dark blue.

lightning-spinner implements the spinner blueprint in the Salesforce Lightning Design System (SLDS). The spinner adapts to SLDS 1 or SLDS 2 styling based on the org's theme or the container app that you use.

SLDS 1SLDS 2
DesignSpinnerSpinner
For Use InLightning Experience, Experience Builder sites, Salesforce mobile app, Lightning Out (Beta), Standalone Lightning app, Mobile OfflineLightning Experience

Here is an example.

lightning-spinner is intended to be used conditionally. You can use if:true and if:false or the Lightning Design System utility classes to show or hide the spinner.

The toggle() function toggles the boolean value of the isLoaded variable.

Use a combination of variants, sizes, and utility classes to customize the slider.

Specify the variant attribute with one of these values.

  • base is the default variant, which shows a gray animated spinner
  • brand shows a blue animated spinner
  • inverse shows a white animated spinner, for use on a darker background

Specify the size attribute with one of these values.

  • xx-small takes up a width of 8px
  • x-small takes up a width of 16px
  • small takes up a width of 20px
  • medium is the default variant, which takes up a width of 32px
  • large takes up a width of 44px

To apply additional styling, use the SLDS utility classes with the class attribute.