Skip to content

Spinner

A circular loading indicator for short waits with no known progress. It takes the text color (currentColor), so it adapts to wherever you put it.

Feedback and status · TaishoDS Core, in plain HTML.

Examples

One working example per case. Each example is the HTML of its preview—copy it as is, and with Core’s CSS and JS loaded, it looks and works the same.

Three sizes

html

When to use

  • The operation is short and you don’t know how long it’ll take.
  • It has to fit in a small spot, like inside a button, next to a heading, or in a cell.
  • It’s enough to say “this is working,” with no further detail.

When not to use

  • You can calculate progress → progress.
  • A structure that will take up space later is loading → skeleton, which prevents layout shift.
  • It’s inline activity in the middle of text → loading-dots.

Do

  • Set the aria-label to what’s being waited on. It’s what the screen reader announces.
  • Put it where the result will appear, so the wait has a place.

Don’t

  • Don’t put up a full-screen spinner if you can draw the structure with skeleton.
  • Don’t leave a spinner running forever. If something fails, show the error.

TaishoDS Core

Doesn’t need JavaScript—it’s markup and CSS.

CSS animation.

From the CDN, without a build, load taisho.spinner.css along with taisho.base.css. That file is all you need.

For how Core works in general, see Behavior.

Accessibility

  • Exposes role="status" with its aria-label (“Loading” by default) as text for screen readers.

Verification

What was actually tested. Anything that wasn’t tested says so—we’d rather say “not verified” than claim too much.

  • axe WCAG 2.2 A + AA in a real browser, in light and dark mode, before every release.
  • keyboard Adds no keys of its own—it uses the browser’s native behavior.
  • screen reader Not verified with a screen reader. Test it in your own combination of components, not just here, where each one appears alone and on its happy path.