# ConfirmDialog

Імперативні діалоги — confirm, alert і prompt через await.


## Приклад


Example (app/demos/confirm/ConfirmBasic.vue):

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

const { confirm, prompt } = useConfirm()
const toast = useToast()
const lastResult = ref<string>('—')

async function remove() {
  const ok = await confirm({
    title: 'Видалити проєкт?',
    message: 'Дію не можна скасувати. Разом із проєктом зникнуть усі його сторінки.',
    confirmText: 'Видалити',
    danger: true,
  })
  lastResult.value = ok ? 'підтверджено' : 'скасовано'
  if (ok) toast.success('Проєкт видалено')
}

async function rename() {
  const name = await prompt({
    title: 'Нова назва',
    input: { label: 'Назва проєкту', placeholder: 'Мій проєкт', required: true },
    confirmText: 'Перейменувати',
  })
  lastResult.value = name === null ? 'скасовано' : `введено: ${name}`
}
</script>

<template>
  <div class="flex flex-col items-center gap-3">
    <div class="flex flex-wrap items-center gap-3">
      <UiButton variant="danger" @click="remove">Видалити проєкт</UiButton>
      <UiButton variant="outline" @click="rename">Перейменувати</UiButton>
    </div>
    <p class="text-sm text-muted">Результат: {{ lastResult }}</p>
  </div>
</template>

```


## Використання

```ts
const { confirm, alert, prompt } = useConfirm()

if (await confirm('Видалити запис?')) {
  await removeRecord()
}

const name = await prompt({
  title: 'Нова назва',
  input: { label: 'Назва', required: true },
})
if (name !== null) await rename(name)
```

Рендерер `UiConfirmDialog` монтується **рівно один раз**, зазвичай в
`app.vue` поруч із `UiToaster`.

## API

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

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

Перед незворотною дією: видалення, скасування підписки, вихід без
збереження.

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

Не питайте підтвердження перед дією, яку легко скасувати. Зайве
підтвердження навчає натискати «Так» не читаючи — і тоді воно не спрацює
там, де справді потрібне. Краще дія + можливість скасувати.

Не використовуйте `window.confirm`: він блокує потік, не стилізується, у
деяких браузерах вимикається галочкою «більше не показувати» і не працює в
iframe із sandbox.

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

Побудований на `UiModal`, а не на власній розмітці — щоб пастка фокуса,
блокування прокрутки і стек шарів були ті самі. Діалог підтвердження майже
завжди відкривається **поверх іншого оверлея**, і саме там власна
реалізація z-index ламалася б.

`confirm` і `alert` мають `role="alertdialog"`, а текст повідомлення
прив'язаний через `aria-describedby`: фокус одразу стає на кнопку, і без
цього скрінрідер оголошував лише «Підтвердіть дію, діалог — Скасувати,
кнопка», не кажучи, що саме видаляється. `prompt` — звичайний `dialog`:
це запит даних, а не попередження.

Фокус ставиться на кнопку підтвердження, а для `prompt` — у поле введення;
`Enter` у полі підтверджує. Виняток — `danger: true`: там фокус отримує
«Скасувати», бо діалог з'являється раптово й Enter, натиснутий за інерцією,
не має незворотно нічого видаляти.

Віддається фокус через проп `initialFocus` самої `UiModal`. Власний
`.focus()` після `nextTick` тут не працює: модалка ставить фокус усередині
`focusTrap.activate()`, тобто пізніше за будь-який `watch` у рендерері, і
мовчки його перебиває.

Повторний виклик, поки попередній діалог відкритий, закриває перший як
«скасовано». Інакше його проміс не зарезолвився б ніколи, і `await` на
ньому завис би назавжди.

На сервері `confirm`, `alert` і `prompt` одразу відповідають «скасовано»
(`false` чи `null`): стан модуля спільний для всіх запитів, а проміс, що
ніколи не резолвиться, підвісив би рендер.


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