# Popover

SSR-безпечна немодальна панель біля trigger з фліпом, focus return і outside click.


## Приклад


Example (app/demos/popover/PopoverBasic.vue):

```vue
<script setup lang="ts">
import { shallowRef } from 'vue'

const open = shallowRef(false)
const notifications = shallowRef(true)
</script>

<template>
  <UiPopover v-model="open" width="18rem" aria-label="Швидкі налаштування">
    <template #trigger="{ triggerAttrs }">
      <UiButton v-bind="triggerAttrs" variant="outline">Налаштування</UiButton>
    </template>
    <template #default="{ close }">
      <div class="space-y-4">
        <div>
          <p class="font-semibold text-ink">Швидкі налаштування</p>
          <p class="mt-1 text-sm text-muted">Зміни застосовуються одразу.</p>
        </div>
        <UiSwitch v-model="notifications" label="Сповіщення" />
        <UiButton size="sm" class="w-full" @click="close">Готово</UiButton>
      </div>
    </template>
  </UiPopover>
</template>

```


## API

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

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

Для компактних фільтрів, налаштувань і довільних немодальних контролів біля
кнопки. Слот trigger отримує `triggerAttrs` — передайте їх реальному
фокусованому елементу.

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

Не використовуйте для критичного підтвердження або довгої форми — беріть
`UiModal` чи `UiDrawer`. Для набору команд із menu-семантикою є `UiMenu`.

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

Відкриття з клавіатури (Enter, Space чи ArrowDown на тригері) переносить
фокус у панель — на перший контроль або, якщо їх немає, на саму панель.
Мишею фокус лишається на тригері, але Tab із нього все одно веде в
панель. Панель телепортована в кінець `body`, тож без цього Tab
перестрибував би відкритий вміст.

Tab з останнього контролу закриває панель і веде до елемента, що йде **за
тригером** на сторінці; Shift+Tab із першого повертає на тригер.

Escape закриває панель і повертає фокус, якщо він був у ній чи на тригері.
`panelRole` дозволяє обрати `dialog`, `group` або прибрати роль, а
`ariaLabel` дає стабільну доступну назву.

## Вкладені шари

Поповер зареєстрований у спільному стеку оверлеїв (`useFloatingLayer`), тож
Escape отримує лише верхній шар: відкритий `UiSelect` чи підказка
всередині панелі закриваються першими, а сам поповер — наступним натиском.

Клік «повз» не рахує нічого, що з'явилося після відкриття поповера:
випадайку селекта всередині, вкладене меню, діалог поверх. Раніше вибір
пункту в селекті всередині поповера закривав поповер ще до того, як
значення встигало змінитися.

Teleport вимкнений на сервері й під час першого client render, тому гідратація
має однакове дерево; перенесення в `body` відбувається після mount.


## Event descriptions

- `update:modelValue`: Панель відкрито або закрито.
- `open`: Панель відкрилася.
- `close`: Панель закрилася.


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