Skeleton

Decorative loading placeholder shapes. Always aria-hidden; announce busy state on the host.

Also known as: loading placeholder, shimmer, pulse placeholder

Installation

Install with the CLI, or copy the component source into your project.

Add skeleton (npm)

npx --yes -p @default-file/ui df-ui add skeleton

Default

Text placeholder at the default width and height. The root is always aria-hidden.

Shapes

Text line, block, and circle silhouettes.

text
block
circle

Width and height

Override instance size with width and height. Prefer spacing and size tokens.

Loading block

Compose shapes into a card placeholder. Keep aria-hidden on each Skeleton and set aria-busy on the host.

Properties

Decorative loading placeholder. Always aria-hidden; the host must announce busy state elsewhere.

Skeleton

PropTypeDefaultNotes
shape"text" | "block" | "circle""text"Placeholder silhouette.
widthstring-Inline CSS width for this instance.
heightstring-Inline CSS height for this instance.
classNamestring-Additional styles on the root.

Accessibility

Decorative only: The root is always aria-hidden. Pair with a parent aria-busy, a Spinner with a name, or live status copy so assistive technology hears the wait.