# EmptyState

Порожній стан із поясненням і дією, що усуває причину порожнечі.


## Приклад


Example (app/demos/empty-state/EmptyStateBasic.vue):

```vue
<script setup lang="ts">
import UiButton from '~/components/ui/UiButton.vue'
import UiEmptyState from '~/components/ui/UiEmptyState.vue'
</script>

<template>
  <div class="w-full max-w-md rounded-card border border-line bg-card">
    <UiEmptyState
      title="Поки що жодного проєкту"
      description="Проєкт збирає сторінки, файли та доступи в одному місці."
      tone="accent"
    >
      <template #icon>
        <svg width="22" height="22" viewBox="0 0 24 24" fill="none" aria-hidden="true">
          <path
            d="M3 7a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v8a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V7Z"
            stroke="currentColor"
            stroke-width="1.8"
            stroke-linejoin="round"
          />
        </svg>
      </template>

      <UiButton size="sm">Створити проєкт</UiButton>
    </UiEmptyState>
  </div>
</template>

```


## API

[Props, events, slots, exposed API (JSON)](https://ui.tatet.net/api/component-meta/UiEmptyState)

## Коли використовувати

Замість порожньої області — завжди. Порожня таблиця без пояснення читається
як помилка завантаження.

## Коли НЕ використовувати

Не використовуйте для помилок. Порожньо і зламано — різні стани, і дія в
них різна: «створити перший проєкт» проти «повторити спробу».

## Доступність

Формулюйте `title` як стан, а не як докір: «Поки що жодного проєкту», а не
«Ви нічого не створили». `description` найкраще використати, щоб пояснити,
що дасть дія — тоді кнопка в слоті стає очевидним наступним кроком.


[Source files, dependencies and ZIP](https://ui.tatet.net/registry/components/empty-state.json)
