Feedback
Guarded Form Drawer
Ящик с формой, который не даёт закрыть себя молча: первое нажатие Escape при заполненной форме поднимает предупреждение, а не теряет введённое.
- drawer
- form
- unsaved
- dialog
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/drawer-006
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «drawer-006» (Guarded Form Drawer) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/drawer-006.json
Registry item: https://vibeui.ru/r/drawer-006.json
Ставится в: components/vibeui/drawer-006.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Ящик с формой, который не даёт закрыть себя молча: первое нажатие Escape при заполненной форме поднимает предупреждение, а не теряет введённое.
Ящик с формой и защитой от случайного закрытия: пока поля не тронуты, Escape закрывает панель как обычно, после первой правки — поднимает полосу с выбором «уйти без сохранения» или «остаться». Ноль зависимостей, один файл, своя палитра.
## 3. Как использовать
import { Drawer006 } from "@/components/vibeui/drawer-006"
<Drawer006
triggerLabel="Редактировать профиль"
title="Профиль"
warning="Изменения не сохранены. Закрыть панель и потерять их?"
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-drawer-006-* и не подменять её токенами вашей темы
- перехват события cancel: без него Escape уносит несохранённое молча
- отсутствие предупреждения у нетронутой формы — спрашивать не о чем, и лишний вопрос обесценивает нужный
- полосу предупреждения над кнопками: выбор должен стоять рядом с причиной, а не всплывать вторым окном
- role="alert" у полосы: предупреждение обязано быть услышано, а не только показано
- отметку «Не сохранено» в шапке: признак изменений виден до попытки уйти
- один onInput на форме вместо подписок на каждое поле: меньше состояния — меньше рассинхрона
## 6. Можно менять
- title — заголовок ящика и его имя для скринридера
- warning — текст предупреждения о несохранённом
- состав полей формы: сейчас это имя, почта и текстовое поле
- triggerLabel и saveLabel — подписи триггера и кнопки сохранения
- поведение отправки: сейчас форма просто закрывает ящик
## 7. Правила
- Компонент ничего не сохраняет: обработчик отправки формы — на вызывающем коде.
- Не превращайте предупреждение во второй диалог: окно поверх окна ломает возврат фокуса.
- Признак изменений ставится по первому вводу и не сбрасывается, если значение вернули вручную.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/drawer-006.jsonhttps://vibeui.ru/r/drawer-006.jsonКомпонент самодостаточен: один файл, без зависимостей, собственная палитра в локальных переменных --vibeui-drawer-006-*. Клиентский: "use client", useState хранит признак изменений и показ предупреждения. Escape перехватывается штатным событием cancel у dialog: event.preventDefault() отменяет закрытие. Форма объявлена method="dialog", поэтому отправка закрывает ящик без обработчика. Признак изменений ставится одним onInput на форме, а не подпиской на каждое поле.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useRef, useState } from "react"
import type { ComponentPropsWithoutRef, CSSProperties } from "react"
export type Drawer006Props = Omit<
ComponentPropsWithoutRef<"div">,
"children" | "title"
> & {
triggerLabel?: string
title?: string
warning?: string
saveLabel?: string
accent?: string
}
// Идея компонента: ящик с формой, который не даёт закрыть себя молча.
// Escape у нативного dialog отменяется событием cancel, поэтому первое
// нажатие при заполненной форме не закрывает панель, а поднимает полосу
// предупреждения с явным выбором: уйти без сохранения или остаться.
const STYLES = `
:where([data-vibeui-block="drawer-006"]){
--vibeui-drawer-006-bg:oklch(1 0 0);
--vibeui-drawer-006-fg:oklch(0.21 0.014 265);
--vibeui-drawer-006-muted:oklch(0.55 0.014 265);
--vibeui-drawer-006-border:oklch(0.91 0.006 265);
--vibeui-drawer-006-accent:oklch(0.55 0.17 265);
--vibeui-drawer-006-warn:oklch(0.62 0.15 65);
--vibeui-drawer-006-warn-bg:oklch(0.96 0.04 85);
--vibeui-drawer-006-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="drawer-006"]{
display:inline-block;font-family:var(--vibeui-drawer-006-font);color:var(--vibeui-drawer-006-fg);
}
[data-vibeui-block="drawer-006"] [data-part="trigger"]{
appearance:none;cursor:pointer;height:2.25rem;padding:0 0.875rem;
border:1px solid var(--vibeui-drawer-006-border);border-radius:0.625rem;
background:var(--vibeui-drawer-006-bg);color:inherit;
font:inherit;font-size:0.8125rem;font-weight:600;
}
[data-vibeui-block="drawer-006"] [data-part="trigger"]:focus-visible{outline:2px solid var(--vibeui-drawer-006-accent);outline-offset:2px}
[data-vibeui-block="drawer-006"] dialog{
position:fixed;inset:0 0 0 auto;margin:0;
width:min(25rem,100vw);max-width:100vw;height:100dvh;max-height:100dvh;
padding:0;border:0;background:var(--vibeui-drawer-006-bg);color:inherit;
box-shadow:-24px 0 60px -30px oklch(0.2 0.02 265 / 55%);
translate:100% 0;transition:translate .22s ease,overlay .22s allow-discrete,display .22s allow-discrete;
}
[data-vibeui-block="drawer-006"] dialog[open]{translate:0 0}
@starting-style{
[data-vibeui-block="drawer-006"] dialog[open]{translate:100% 0}
}
[data-vibeui-block="drawer-006"] dialog::backdrop{background:oklch(0.19 0.02 265 / 45%)}
[data-vibeui-block="drawer-006"] form{display:flex;flex-direction:column;height:100%;box-sizing:border-box}
[data-vibeui-block="drawer-006"] [data-part="head"]{
display:flex;align-items:center;justify-content:space-between;gap:0.75rem;
padding:1rem 1rem 0.75rem;border-bottom:1px solid var(--vibeui-drawer-006-border);
}
[data-vibeui-block="drawer-006"] [data-part="title"]{margin:0;font-size:1rem;font-weight:680}
[data-vibeui-block="drawer-006"] [data-part="mark"]{
font-size:0.6875rem;font-weight:700;color:var(--vibeui-drawer-006-warn);
}
[data-vibeui-block="drawer-006"] [data-part="body"]{
flex:1;min-height:0;overflow-y:auto;padding:1rem;
display:flex;flex-direction:column;gap:0.875rem;
}
[data-vibeui-block="drawer-006"] [data-part="field"]{display:flex;flex-direction:column;gap:0.3125rem}
[data-vibeui-block="drawer-006"] [data-part="label"]{font-size:0.75rem;font-weight:650;color:var(--vibeui-drawer-006-muted)}
[data-vibeui-block="drawer-006"] input,
[data-vibeui-block="drawer-006"] textarea{
box-sizing:border-box;width:100%;
border:1px solid var(--vibeui-drawer-006-border);border-radius:0.625rem;
background:var(--vibeui-drawer-006-bg);color:inherit;
font:inherit;font-size:0.875rem;padding:0.5rem 0.6875rem;
}
[data-vibeui-block="drawer-006"] input{height:2.375rem}
[data-vibeui-block="drawer-006"] textarea{min-height:5rem;resize:vertical}
[data-vibeui-block="drawer-006"] input:focus-visible,
[data-vibeui-block="drawer-006"] textarea:focus-visible{outline:2px solid var(--vibeui-drawer-006-accent);outline-offset:1px;border-color:transparent}
/* Полоса предупреждения живёт над кнопками: выбор рядом с причиной. */
[data-vibeui-block="drawer-006"] [data-part="warning"]{
display:flex;flex-wrap:wrap;align-items:center;gap:0.5rem;
margin:0 1rem;padding:0.625rem 0.75rem;border-radius:0.75rem;
background:var(--vibeui-drawer-006-warn-bg);
border:1px solid color-mix(in oklab,var(--vibeui-drawer-006-warn) 40%,transparent);
font-size:0.8125rem;
}
[data-vibeui-block="drawer-006"] [data-part="warning"] p{margin:0;flex:1 1 12rem}
[data-vibeui-block="drawer-006"] [data-part="warning"] button{
appearance:none;border:0;background:transparent;cursor:pointer;padding:0;
font:inherit;font-size:0.8125rem;font-weight:700;color:var(--vibeui-drawer-006-fg);
}
[data-vibeui-block="drawer-006"] [data-part="warning"] button[data-role="leave"]{color:var(--vibeui-drawer-006-warn)}
[data-vibeui-block="drawer-006"] [data-part="warning"] button:focus-visible{outline:2px solid var(--vibeui-drawer-006-accent);outline-offset:2px;border-radius:0.25rem}
[data-vibeui-block="drawer-006"] [data-part="foot"]{
display:flex;gap:0.5rem;margin-top:0.75rem;
padding:0.75rem 1rem calc(0.75rem + env(safe-area-inset-bottom,0px));
border-top:1px solid var(--vibeui-drawer-006-border);
}
[data-vibeui-block="drawer-006"] [data-part="foot"] button{
appearance:none;cursor:pointer;flex:1;height:2.5rem;border-radius:0.625rem;
border:1px solid var(--vibeui-drawer-006-border);background:transparent;color:inherit;
font:inherit;font-size:0.875rem;font-weight:600;
}
[data-vibeui-block="drawer-006"] [data-part="foot"] button[data-primary="true"]{
border-color:transparent;background:var(--vibeui-drawer-006-accent);color:oklch(0.99 0.01 265);
}
[data-vibeui-block="drawer-006"] [data-part="foot"] button:focus-visible{outline:2px solid var(--vibeui-drawer-006-accent);outline-offset:2px}
@media (prefers-reduced-motion:reduce){
[data-vibeui-block="drawer-006"] *{animation:none!important;transition:none!important}
[data-vibeui-block="drawer-006"] dialog{translate:0 0}
}
`
/**
* Ящик с формой и защитой от случайного закрытия: Escape сначала спрашивает.
* Один файл, ноль зависимостей, собственная палитра.
*/
export function Drawer006({
triggerLabel = "Редактировать профиль",
title = "Профиль",
warning = "Изменения не сохранены. Закрыть панель и потерять их?",
saveLabel = "Сохранить",
accent,
className,
style,
...props
}: Drawer006Props) {
const drawer = useRef<HTMLDialogElement>(null)
const [dirty, setDirty] = useState(false)
const [asking, setAsking] = useState(false)
const palette = {
...(accent ? { "--vibeui-drawer-006-accent": accent } : null),
...style,
} as CSSProperties
function open() {
setDirty(false)
setAsking(false)
drawer.current?.showModal()
}
function leave() {
setDirty(false)
setAsking(false)
drawer.current?.close()
}
function request() {
if (dirty) {
setAsking(true)
return
}
leave()
}
return (
<>
<style href="vibeui-drawer-006" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="drawer-006"
className={className}
style={palette}
>
<button type="button" data-part="trigger" onClick={open}>
{triggerLabel}
</button>
<dialog
ref={drawer}
aria-label={title}
onCancel={(event) => {
if (dirty) {
event.preventDefault()
setAsking(true)
}
}}
>
<form
method="dialog"
onInput={() => setDirty(true)}
onSubmit={() => leave()}
>
<div data-part="head">
<h2 data-part="title">{title}</h2>
{dirty ? <span data-part="mark">Не сохранено</span> : null}
</div>
<div data-part="body">
<label data-part="field">
<span data-part="label">Отображаемое имя</span>
<input name="name" defaultValue="Анна Ковалёва" />
</label>
<label data-part="field">
<span data-part="label">Почта для уведомлений</span>
<input
name="email"
type="email"
defaultValue="anna@studio.ru"
/>
</label>
<label data-part="field">
<span data-part="label">О себе</span>
<textarea
name="about"
defaultValue="Собираю интерфейсы и веду каталог компонентов."
/>
</label>
</div>
{asking ? (
<div data-part="warning" role="alert">
<p>{warning}</p>
<button type="button" data-role="leave" onClick={leave}>
Уйти без сохранения
</button>
<button type="button" onClick={() => setAsking(false)}>
Остаться
</button>
</div>
) : null}
<div data-part="foot">
<button type="button" onClick={request}>
Отмена
</button>
<button type="submit" data-primary="true">
{saveLabel}
</button>
</div>
</form>
</dialog>
</div>
</>
)
}