Skip to contentKino
Skip to Content

Empty

What shows where a list, a page or a panel has nothing in it. A picture, what belongs there and the next step, rising into place when it comes back in place of content just cleared or filtered away.

npx shadcn add https://kinoui.com/r/empty.json
Share on

Examples

You’re all caught up

Inbox

Nothing unread
You’re all caught up

Mentions, assignments and review requests land here.

Default

Give show the condition it shows on and keep it mounted: when the list empties it rises into place, and a page that opens empty simply shows it.

Mobile app

0 issues
No issues in Mobile app yet

Issues track the work in a project. Create the first one, or bring yours over from another tool.

Stack

variant="stack" puts the icon in the first of three outlined rows, so the space reads as a list waiting for its rows. variant="outline" on Empty draws a dashed edge.

Issues

Kino · Mobile app
0 issues
No issues match “roadmap”

Check the spelling, or search by an issue’s number, such as KN-142.

No results

Say what was looked for and how to clear it. Announce the count in a status region that is there before the search, and send focus back to the field when the search clears.

No picture

Leave out EmptyMedia in a narrow panel, where the words are enough. With show left out it never moves.

Installation

npx shadcn@latest add https://kinoui.com/r/empty.json
Files
lib/reduce-motion.tscomponents/kino/empty.tsx
Packages
@base-ui/reactclass-variance-authority

New to Kino? Installation covers what your project needs first and the @kino namespace.

API reference

Empty

PropTypeDefaultDescription
showbooleanNoneWhether it shows. Keep it mounted and give the condition: it rises into place when it comes back after being hidden, and is simply there when it shows from the start. Left out, it always shows and never moves.
variant"default""outline""default"Outline draws a dashed edge, for an empty state that shares the page with other content.

EmptyMedia

PropTypeDefaultDescription
variant"default""icon""stack""default"Default shows what it holds as it is, such as an avatar. Icon puts an icon in a tile. Stack puts it in the first of three outlined rows.

Data attributes

AttributeOnDescription
data-arrivedEmptyPresent once it has come back after being hidden, while its entrance plays and after.

CSS variables

VariableSet it onDefaultDescription
--empty-riseEmpty, or <body>0.5remHow far the words and the actions rise as it comes back.

Accessibility

  • An empty state that replaces search results is not announced by itself: keep a role="status" region on the page from the start and write the result into it.
  • When the control that had focus goes with the content, such as the last row’s button, move focus to the empty state’s action.
  • The picture is hidden from screen readers. The title says what is empty.
  • The title is a div. Render a heading where the page’s outline needs one.
  • When the system asks for less motion, it only fades in.