# Alert

Інлайн-повідомлення з п'ятьма тонами, стандартною іконкою та опційним закриттям.


Банер повідомлення для контексту на сторінці — не оверлей і не тост: він
живе в потоці вмісту і не зникає сам.

## Приклад


Example (app/demos/alert/AlertBasic.vue):

```vue
<script setup lang="ts">
import { ref } from 'vue'
import UiAlert from '~/components/ui/UiAlert.vue'

const visible = ref(true)
</script>

<template>
  <div class="flex flex-col gap-3">
    <UiAlert tone="info" title="Заплановане обслуговування">
      29 серпня з 02:00 до 03:00 сервіс буде недоступний.
    </UiAlert>
    <UiAlert tone="success" title="Збережено">Зміни опубліковано на всіх мовах.</UiAlert>
    <UiAlert tone="warning">Квоту зберігання вичерпано на 90% — очистіть старі файли.</UiAlert>
    <UiAlert tone="danger" title="Помилка збереження" dismissible @dismiss="visible = false">
      Сервер не відповів. Спробуйте ще раз або скопіюйте текст у буфер.
    </UiAlert>
    <UiAlert v-if="visible" tone="neutral" title="Чернетка" dismissible @dismiss="visible = false">
      Ця сторінка ще не опублікована.
    </UiAlert>
  </div>
</template>
```


## API

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

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

Для стану, що стосується вмісту поруч: результат дії над формою,
попередження перед небезпечною секцією, банер ліміту.

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

Для миттєвих підтверджень дій («Збережено») є Toast — Alert не зникає сам
і не має.

Не передавайте тон лише кольором: кожен тон має іконку, а `danger` —
`role="alert"`, щоб скрінрідер повідомив негайно.

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

`role="alert"` лише на `danger`: перебивати потік читання успіхами й
порадами так само погано, як мовчати про помилку. Хрестик має
`aria-label="Закрити"` і збільшену зону натискання (`-m-1 p-1`), а на
дотику — ще й невидиму зону 45×45, той самий патерн, що в UiButton: сам
хрестик близько 22px, і палець промахувався в текст повідомлення.

## Event descriptions

- `dismiss`: Натиснуто хрестик. Компонент не ховається сам — ховає батьківський стан.


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