shoelace/docs/components/spinner.md

1.7 KiB

Spinner

[component-header:sl-spinner]

Spinners are used to show the progress of an indeterminate operation.

<sl-spinner></sl-spinner>
import { SlSpinner } from '@shoelace-style/shoelace/dist/react';

const App = () => <SlSpinner />;

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.

<sl-spinner></sl-spinner>
<sl-spinner style="font-size: 2rem;"></sl-spinner>
<sl-spinner style="font-size: 3rem;"></sl-spinner>
import { SlSpinner } from '@shoelace-style/shoelace/dist/react';

const App = () => (
  <>
    <SlSpinner />
    <SlSpinner style={{ fontSize: '2rem' }} />
    <SlSpinner style={{ fontSize: '3rem' }} />
  </>
);

Track Width

The width of the spinner's track can be changed by setting the --track-width custom property.

<sl-spinner style="font-size: 50px; --track-width: 10px;"></sl-spinner>
import { SlSpinner } from '@shoelace-style/shoelace/dist/react';

const App = () => (
  <SlSpinner
    style={{
      fontSize: '3rem',
      '--track-width': '6px'
    }}
  />
);

Color

The spinner's colors can be changed by setting the --indicator-color and --track-color custom properties.

<sl-spinner style="font-size: 3rem; --indicator-color: deeppink; --track-color: pink;"></sl-spinner>
import { SlSpinner } from '@shoelace-style/shoelace/dist/react';

const App = () => (
  <SlSpinner
    style={{
      fontSize: '3rem',
      '--indicator-color': 'deeppink',
      '--track-color': 'pink'
    }}
  />
);

[component-metadata:sl-spinner]