Skip to content

Skeleton

An animated placeholder that reserves space for content while it loads, so nothing jumps when it arrives. Size is set with utilities (w-*, h-*, size-*) and shape with variant-text, variant-circle, or variant-rect.

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.

Text loading placeholders

html

When to use

  • You’re about to load content whose shape you already know, like a list, a card, or a profile.
  • You want to avoid the layout shift content causes when it appears.
  • It’s the first load, and filling the screen makes the wait feel shorter.

When not to use

  • The wait is for a one-off action, not content → spinner.
  • You know the percentage of progress → progress.
  • There’s no content to load because it’s genuinely empty → empty-state.

Do

  • Copy the real shape of the content, with the same sizes and the same order.
  • It’s decorative. Add a status text if the user needs to know something is loading.

Don’t

  • Don’t draw a skeleton that doesn’t resemble what arrives. The jump still happens.
  • Don’t use it for waits of several seconds with no other notice.

TaishoDS Core

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

CSS animation.

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

For how Core works in general, see Behavior.

Accessibility

  • It’s decorative and announces nothing to screen readers. Pair it with status text (for example, an aria-live “Loading…”) if the context needs it. With prefers-reduced-motion, the shimmer stops and a soft fixed tone remains.

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.