Перейти до вмісту
tatetUI

Drawer

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

Використати у своєму проєкті

Вихідний код, залежності та стилі. Без клонування Git.

Завантажити ZIP
JSON для агентаДокументація Markdown
Файли для перенесення · 12

Підключення 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

НазваТипТиповоОпис
titlestring""Заголовок. Ігнорується, якщо задано слот `header`.
positionrightlefttopbottom"right"З якого краю виїжджає панель.
sizelgxssmmdxl2xlfullauto"lg"Розмір поперек напрямку: ширина для left/right, висота для top/bottom.
panelClassstring""Додаткові класи панелі. Якщо задано, замінює стандартний фон.
initialFocusstring—CSS-селектор усередині панелі, якому віддати фокус при відкритті. Типово фокус отримує сама панель — щоб на мобільних не піднімалася клавіатура.
ariaLabelstring—Доступне ім'я панелі, коли слот `header` не є заголовком. Без нього aria-labelledby вказує на контейнер слота, і якщо там лежить поле вводу — ім'я панелі обчислюється з його ЗНАЧЕННЯ, як це було з пошуком у UiModal.
modelValuebooleanfalseВідкрито. Використовуйте через `v-model`.
closablebooleantrueПоказувати хрестик і дозволяти закриття через Escape.
noPaddingbooleanfalseПрибрати внутрішні відступи вмісту.
closeOnBackdropbooleanfalseКлік по затемненому фону закриває drawer. Типово ВИМКНЕНО — на відміну від UiModal. Drawer майже завжди містить форму, і випадковий клік повз панель не має знищувати незбережене введення.
persistentbooleanfalseНі Escape, ні клік по фону не закривають — лише явна дія.
swipeToClosebooleantrueСвайп вниз закриває нижній drawer. Вимикається, якщо заважає.
swipeToCloseSidebooleanfalseСвайп до краю закриває бічний 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, копіювати композабли удруге не потрібно.