Skip to content

Progress Spinner

Use ProgressSpinner to indicate ongoing activity or a loading state. Render it on its own, or wrap other content as children to overlay the spinner on a dimmed background while that content updates.

The SDK ProgressSpinner showing a loading indicator over content.
import { ProgressSpinner } from '/@dropins/tools/components.js';
PropTypeReq?Description
size'small' | 'medium' | 'big' | 'large'NoSize of the spinner. Defaults to small.
stroke'1' | '2' | '3' | '4'NoStroke width of the spinner. Defaults to 4.
ariaLabelstringNoAccessible label for the spinner.

ProgressSpinner also accepts standard HTML attributes (for example, className, style), except size. Pass children to render the spinner as an overlay on top of that content.

import { ProgressSpinner, provider } from '/@dropins/tools/components.js';
await provider.render(ProgressSpinner, {
size: 'medium',
stroke: '4',
ariaLabel: 'Updating',
})(document.querySelector('.progress-spinner'));
  • Button — often renders a spinner while an action is in progress.
  • Design tokens — the colors and sizing the spinner uses.