Drawer
Бічна панель, що виїжджає з будь-якого краю й закривається свайпом — униз знизу, до краю збоку.
Використати у своєму проєкті
Вихідний код, залежності та стилі. Без клонування Git.
Файли для перенесення · 12
- app/assets/css/components.css
- app/assets/css/theme.css
- app/assets/css/tokens.css
- app/components/ui/UiDrawer.vue
- app/composables/useFocusTrap.ts
- app/composables/useLazyTeleport.ts
- app/composables/useOverlayStack.ts
- app/composables/useReducedMotion.ts
- app/composables/useScrollEdges.ts
- app/composables/useScrollLock.ts
- app/composables/useUiText.ts
- app/utils/swipe.ts
Підключення CSS та налаштування імпортів — в інструкції для агентів.
Drawer ділить overlay-ядро з UiModal, але має протилежний типовий
closeOnBackdrop. Це не непослідовність, а різне призначення: модалка
зазвичай інформаційна, drawer майже завжди містить форму. Випадковий клік
повз панель не має знищувати заповнене.
Приклад
Шапка й футер — як у UiModal: пласкі, назва по центру, кругле тло хрестика
без рамки. У панелі на всю висоту екрана саме центр робить шапку шапкою —
назва ліворуч читалася як перший рядок вмісту. Лінія під шапкою з'являється,
лише коли вміст прокручено під неї, а над футером — поки нижче лишився
непрокручений вміст.
Позиції
Свайп бічної панелі
З swipe-to-close-side бічну панель закриває свайп до її краю: ліву —
ліворуч, праву — праворуч. Панель іде за пальцем із будь-якого місця, фон
світлішає разом із нею; відпустили далі ~третини ширини чи різко кинули —
панель доїжджає за край і закривається, інакше плавно повертається.
<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
| Назва | Тип | Типово | Опис |
|---|---|---|---|
title | string | "" | Заголовок. Ігнорується, якщо задано слот `header`. |
position | rightlefttopbottom | "right" | З якого краю виїжджає панель. |
size | lgxssmmdxl2xlfullauto | "lg" | Розмір поперек напрямку: ширина для left/right, висота для top/bottom. |
panelClass | string | "" | Додаткові класи панелі. Якщо задано, замінює стандартний фон. |
initialFocus | string | — | CSS-селектор усередині панелі, якому віддати фокус при відкритті. Типово фокус отримує сама панель — щоб на мобільних не піднімалася клавіатура. |
ariaLabel | string | — | Доступне ім'я панелі, коли слот `header` не є заголовком. Без нього aria-labelledby вказує на контейнер слота, і якщо там лежить поле вводу — ім'я панелі обчислюється з його ЗНАЧЕННЯ, як це було з пошуком у UiModal. |
modelValue | boolean | false | Відкрито. Використовуйте через `v-model`. |
closable | boolean | true | Показувати хрестик і дозволяти закриття через Escape. |
noPadding | boolean | false | Прибрати внутрішні відступи вмісту. |
closeOnBackdrop | boolean | false | Клік по затемненому фону закриває drawer. Типово ВИМКНЕНО — на відміну від UiModal. Drawer майже завжди містить форму, і випадковий клік повз панель не має знищувати незбережене введення. |
persistent | boolean | false | Ні Escape, ні клік по фону не закривають — лише явна дія. |
swipeToClose | boolean | true | Свайп вниз закриває нижній drawer. Вимикається, якщо заважає. |
swipeToCloseSide | boolean | false | Свайп до краю закриває бічний drawer: лівий — ліворуч, правий — праворуч. Панель іде за пальцем із будь-якого місця; вертикальна прокрутка вмісту й області `overflow-x-auto` лишаються пальцю. Типово ВИМКНЕНО: у бічній панелі буває вміст, що сам слухає горизонтальні рухи пальця (повзунки, полотно, карта). |
Події
| Назва | Payload | Опис |
|---|---|---|
update:modelValue | [value: boolean] | Зміна стану відкриття. Використовуйте через `v-model`. |
close | [] | Панель закрито — хрестиком, Escape, кліком по фону або свайпом. |
Слоти
| Назва | Опис |
|---|---|
default | Вміст панелі. |
header | Замінює заголовок цілком. Тоді `title` не використовується. |
footer | Кнопки дій. Футер не рендериться, якщо слот порожній. |
Коли використовувати
Для форм і панелей деталей, де користувач має бачити контекст під панеллю або де вмісту забагато для модалки.
Нижня позиція (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, копіювати композабли удруге
не потрібно.