Skip to main content

Placeholders

Use loading placeholders for your components or pages to indicate something may still be loading.

About

Placeholders can be used to enhance the experience of your application. They’re built only with HTML and CSS, meaning you don’t need any JavaScript to create them. You will, however, need some custom JavaScript to toggle their visibility. Their appearance, color, and sizing can be easily customized with our utility classes.

Example

In the example below, we take a typical card component and recreate it with placeholders applied to create a “loading card”. Size and proportions are the same between the two.

Result
Loading...
Live Editor

Width

You can change the width through grid column classes, width utilities, or inline styles.

Result
Loading...
Live Editor

Color

By default, the Placeholder uses currentColor. This can be overridden with a custom color or utility class.

Result
Loading...
Live Editor

Sizing

The size of Placeholders are based on the typographic style of the parent element. Customize them with sizing props: lg, sm, or xs.

Result
Loading...
Live Editor

Animation

Animate placeholders by setting the prop animation to glow or wave to better convey the perception of something being actively loaded.

Result
Loading...
Live Editor

API

Placeholder

PlaceholderButton