# Drawer

Бічна панель, що виїжджає з будь-якого краю й закривається свайпом — униз знизу, до краю збоку.


Drawer ділить overlay-ядро з `UiModal`, але має протилежний типовий
`closeOnBackdrop`. Це не непослідовність, а різне призначення: модалка
зазвичай інформаційна, drawer майже завжди містить форму. Випадковий клік
повз панель не має знищувати заповнене.

## Приклад


Example (app/demos/drawer/DrawerBasic.vue):

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

const open = ref(false)
</script>

<template>
  <UiButton @click="open = true">Редагувати профіль</UiButton>

  <UiDrawer v-model="open" title="Редагування профілю" size="sm">
    <div class="space-y-4">
      <p class="text-muted">
        Клік по затемненому фону тут навмисно НЕ закриває панель: усередині
        форма, і випадковий клік повз неї не має знищити введене.
      </p>
      <p class="text-muted">Закрити можна хрестиком або клавішею Escape.</p>
    </div>

    <template #footer>
      <UiButton variant="tonal" @click="open = false">Скасувати</UiButton>
      <UiButton @click="open = false">Зберегти</UiButton>
    </template>
  </UiDrawer>
</template>

```


Шапка й футер — як у `UiModal`: пласкі, назва по центру, кругле тло хрестика
без рамки. У панелі на всю висоту екрана саме центр робить шапку шапкою —
назва ліворуч читалася як перший рядок вмісту. Лінія під шапкою з'являється,
лише коли вміст прокручено під неї, а над футером — поки нижче лишився
непрокручений вміст.

## Позиції


Example (app/demos/drawer/DrawerPositions.vue):

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

type Position = 'left' | 'right' | 'top' | 'bottom'

const open = ref(false)
const position = ref<Position>('right')

function show(next: Position) {
  position.value = next
  open.value = true
}
</script>

<template>
  <div class="flex flex-wrap gap-3">
    <UiButton variant="outline" @click="show('left')">Ліворуч</UiButton>
    <UiButton variant="outline" @click="show('right')">Праворуч</UiButton>
    <UiButton variant="outline" @click="show('top')">Згори</UiButton>
    <UiButton variant="outline" @click="show('bottom')">Знизу</UiButton>
  </div>

  <UiDrawer v-model="open" :position="position" :title="`Позиція: ${position}`" size="sm">
    <p class="text-muted">
      Напрямок анімації задається модифікатором класу на корені, а не окремою
      назвою переходу — інакше набір enter/leave-класів довелося б дублювати
      чотири рази.
    </p>
    <p v-if="position === 'bottom'" class="mt-3 text-muted">
      Нижню панель можна закрити свайпом за ручку зверху.
    </p>
  </UiDrawer>
</template>

```


## Свайп бічної панелі

З `swipe-to-close-side` бічну панель закриває свайп до її краю: ліву —
ліворуч, праву — праворуч. Панель іде за пальцем із будь-якого місця, фон
світлішає разом із нею; відпустили далі ~третини ширини чи різко кинули —
панель доїжджає за край і закривається, інакше плавно повертається.


Example (app/demos/drawer/DrawerSideSwipe.vue):

```vue
<script setup lang="ts">
import { ref } from 'vue'
import UiButton from '~/components/ui/UiButton.vue'
import UiDrawer from '~/components/ui/UiDrawer.vue'
import { menuItemClass } from '~/utils/uiFieldStyles'

const open = ref(false)
const ITEMS = ['Контакти', 'Нова група', 'Архів', 'Налаштування', 'Довідка', 'Про застосунок']
const TAGS = ['Усі', 'Особисті', 'Робота', 'Канали', 'Боти', 'Непрочитані', 'Архів']
</script>

<template>
  <UiButton @click="open = true">Головне меню</UiButton>

  <UiDrawer v-model="open" position="left" size="xs" title="Меню" close-on-backdrop swipe-to-close-side>
    <p class="mb-3 text-muted">
      На телефоні потягніть панель ліворуч. Смуга нижче прокручується вбік і
      панель не тягне.
    </p>
    <div class="-mx-4 mb-3 flex gap-2 overflow-x-auto px-4 pb-1 sm:-mx-5 sm:px-5">
      <span
        v-for="tag in TAGS"
        :key="tag"
        class="shrink-0 rounded-full border border-line bg-subtle px-3 py-1 text-sm text-ink"
      >
        {{ tag }}
      </span>
    </div>
    <div class="-mx-2 flex flex-col">
      <button v-for="item in ITEMS" :key="item" type="button" :class="[menuItemClass, 'text-ink']" @click="open = false">
        {{ item }}
      </button>
    </div>
  </UiDrawer>
</template>

```


```vue
<UiDrawer v-model="open" position="left" size="xs" close-on-backdrop swipe-to-close-side>
  …
</UiDrawer>
```

Типово вимкнено, бо в бічній панелі буває вміст, що сам слухає
горизонтальні рухи пальця. Жест бере лише явно горизонтальний рух, тож
вертикальна прокрутка вмісту лишається прокруткою. Не починається він і з
області, що прокручується вбік (`overflow-x-auto` зі вмістом, ширшим за неї),
з полів, повзунків, полотна, будь-чого з `touch-action: none` чи
`data-no-swipe`. Миша свайпом не користується.

Власна область вертикальної прокрутки в слоті має бути `overflow-y-auto`
без `overflow-x-auto`: їй панель сама віддає `touch-action: pan-y
pinch-zoom`, інакше браузер забирав би горизонтальний рух собі. Область
`overflow-auto` (в обидва боки) лишається прокрутці — і з неї жест не
почнеться.

## API

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

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

Для форм і панелей деталей, де користувач має бачити контекст під панеллю
або де вмісту забагато для модалки.

Нижня позиція (`position="bottom"`) — природний вибір для мобільних дій:
панель ближче до великого пальця, ніж будь-що вгорі екрана.

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

Не робіть drawer заміною сторінки. Якщо на вміст треба дати посилання,
повернутися до нього кнопкою «назад» або відкрити в новій вкладці — це
сторінка, а не панель.

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

Назва панелі — з `title`, зі слота `header` або з `ariaLabel`. Коли в
`header` не заголовок, а поле пошуку чи перемикач, задайте `ariaLabel`
явно: інакше назву обчислить браузер зі **значення** поля. Без жодної
назви панель оголошується за краєм — «Бічна панель», «Верхня панель» чи
«Нижня панель».

Свайп униз закриває нижню панель (`swipe-to-close`, типово ввімкнено),
свайп до краю — бічну (`swipe-to-close-side`, типово вимкнено); обидва —
лише коли `closable`. Свайп — додатковий шлях: хрестик, Escape і системне
«назад» лишаються, тож людина без точних жестів закриває панель так само.
Ручка та шапка нижньої панелі мають `touch-none` — без нього браузер забирає
вертикальний жест собі як прокрутку сторінки, і панель не рухається.

Нижня закривається за пройденою чвертю висоти, бічна — третиною ширини;
обидві — і за різким флінгом: короткий швидкий рух — теж однозначний намір
закрити. Відпущена раніше панель повертається на місце з анімацією, а не
стрибком.

Свайп лише **просить** закрити через `update:modelValue`. Якщо батько
відмовив — скажімо, спершу питає «Відкинути незбережені зміни?» — панель
повертається на місце, а не лишається зсунутою за край невидимою.

## Портування

Ті самі композабли, що й для `UiModal`, плюс `utils/swipe.ts` для свайпу
бічної панелі. Якщо в проєкті вже є `UiModal`, копіювати композабли удруге
не потрібно.


## Event descriptions

- `update:modelValue`: Зміна стану відкриття. Використовуйте через `v-model`.
- `close`: Панель закрито — хрестиком, Escape, кліком по фону або свайпом.


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