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 #actions slot.

Show an empty state

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

Use a custom icon

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

Props

PropTypeDefaultDescription
titlestring | nullHeadline.
subtitlestring | nullSupporting text.
useCustomIconbooleanfalseRender the #icon slot instead of the default icon.
rolestring'status'ARIA role.
ariaLabelstring'Empty state'Accessible name.
ariaLive'off' | 'polite' | 'assertive''polite'Live-region politeness.
customClassstring | string[] | nullExtra classes.

Slots: #icon, #actions.

Copyright © 2026