Components

Empty

Communicate an empty state with an icon, message, and optional action.

UiEmpty renders an accessible empty state. Add a call to action via the #action slot — empty states almost always need one.

Show an empty state

<template>
  <UiEmpty title="No projects yet" subtitle="Create your first project to get started.">
    <template #action>
      <UiButton variant="filled" color="primary" text="New project" />
    </template>
  </UiEmpty>
</template>

Use a custom icon

Set use-custom-icon and pass a Material icon code to replace the default animated icon.

<template>
  <UiEmpty title="Inbox zero" use-custom-icon icon-code="&#xe156;" />
</template>

Props

PropTypeDefaultDescription
titlestring | nullHeadline.
subtitlestring | nullSupporting text.
useCustomIconbooleanfalseRender iconCode as a static icon instead of the default animated icon.
iconCodestring'&#xeb83;'Material icon code used when useCustomIcon is true.
rolestring'status'ARIA role.
ariaLabelstring'Empty state'Accessible name.
ariaLive'off' | 'polite' | 'assertive''polite'Live-region politeness.
customClassstring | string[] | nullExtra classes.

Slots: #action — call-to-action content (usually a UiButton) rendered below the title/subtitle. The legacy #button slot name still works as a fallback when #action is unused.

Copyright © 2026