Skip to content

EmptyState

The block that appears when a list, table, or view has no content. It brings the icon, title, description, and action together, centered, instead of repeating the HTML on every screen.

Content · 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.

Empty list with action

No deployments yet

Launch your first one and it’ll show up in this list.

html

When to use

  • A list or table can end up empty, whether for the first time or because of a filter.
  • You want to turn the empty state into a first step, like creating, importing, or inviting.
  • You need to tell “nothing here yet” apart from “your search found nothing.”

When not to use

  • It’s still loading. That’s a skeleton or spinner, not an empty state.
  • It’s a system error, not a state without data → banner or note.

Do

  • Say why it’s empty and what to do. The action goes in the block itself.
  • Distinguish the initial empty state from one caused by a filter. The second offers to clear the filter.

Don’t

  • Don’t leave a table blank without an explanation. It looks broken.
  • Don’t use the same text for “no data” and “no results.”

TaishoDS Core

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

A composition of text and an icon.

From the CDN, without a build, load taisho.empty-state.css along with taisho.base.css. Also load:

  • taisho.icon.css

For how Core works in general, see Behavior.

Accessibility

  • The icon is decorative (aria-hidden). The text conveys the message.
  • The title and description are real text that screen readers can read.

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.