Resizable
Three Panes
Три панели и два разделителя: состояние хранится как положения границ, поэтому каждая граница просто зажимается между соседями и панели не разъезжаются.
- resizable
- splitter
- three-panes
- keyboard
Превью
Использовать с AI
- 1. Скопируйте ссылку.
- 2. Напишите агенту своими словами и вставьте её в предложение.
- 3. Агент откроет ссылку и поставит компонент из registry.
размести это в шапке: https://vibeui.ru/c/resizable-002
Проекты
- Витрина
- Каталог
- Документы
Задачи
- Собрать реестр
- Проверить превью
- Обновить документацию
Описание
Правая панель забирает остаток ширины, поэтому сумма всегда сходится к сотне процентов без пересчёта.
26% · 40% · 34%
Показать полную инструкцию
То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.
# Установка и размещение «resizable-002» (Three Panes) из VibeUI
## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/resizable-002.json
Registry item: https://vibeui.ru/r/resizable-002.json
Ставится в: components/vibeui/resizable-002.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.
Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.
## 2. Что это
Три панели и два разделителя: состояние хранится как положения границ, поэтому каждая граница просто зажимается между соседями и панели не разъезжаются.
Три панели с двумя разделителями: границы зажаты между соседями, обе полосы работают мышью и с клавиатуры. Один файл, ноль зависимостей.
## 3. Как использовать
import { Resizable002 } from "@/components/vibeui/resizable-002"
<Resizable002
defaultLeft={26}
defaultMiddle={40}
min={14}
step={3}
/>
Полный список пропсов — в установленном файле.
## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.
Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)
## 5. Сохранить как установлено
- локальную палитру --vibeui-resizable-002-* и не подменять её токенами вашей темы
- хранение границ вместо ширин: на трёх ширинах округление разводит панели
- зажим границы между соседней границей и минимумом — иначе панели схлопываются друг в друга
- role="separator" с aria-valuenow у обеих полос, а не у одной
- разные имена разделителей: две одинаковые «границы» с клавиатуры неразличимы
- min-width:0 у панелей, иначе содержимое не даст им сжиматься
## 6. Можно менять
- начальные размеры через defaultLeft и defaultMiddle
- минимальную долю панели через min и шаг клавиатуры через step
- имя разделителей через label
- цвет активной полосы через accent
## 7. Правила
- aria-valuenow здесь — положение границы, а не ширина панели: это честнее для двух полос сразу.
- min задаётся в процентах и действует на все три панели одинаково.
- Третья панель не хранит размер: не пытайтесь задать ей ширину, она забирает остаток.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.
## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.Для разработчика
npx shadcn@latest add https://vibeui.ru/r/resizable-002.jsonhttps://vibeui.ru/r/resizable-002.jsonОдин файл, ноль зависимостей, палитра --vibeui-resizable-002-*. Клиентский: useState с массивом из двух границ, useRef на рамку, useId на идентификаторы панелей. Модель данных выбрана осознанно: хранятся не три ширины, а две границы — тогда ограничение сводится к зажиму между соседней границей и минимумом, а сумма всегда сходится, потому что третья панель забирает остаток. Оба разделителя — полноценные role="separator" с tabIndex 0, aria-valuenow/min/max, aria-controls и обработкой стрелок, Home и End; тяга держится на setPointerCapture.
Исходник компонента
Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.
"use client"
import { useId, useRef, useState } from "react"
import type {
ComponentPropsWithoutRef,
CSSProperties,
KeyboardEvent,
PointerEvent,
} from "react"
export type Resizable002Props = Omit<
ComponentPropsWithoutRef<"div">,
"children" | "onChange"
> & {
label?: string
min?: number
step?: number
defaultLeft?: number
defaultMiddle?: number
onChange?: (sizes: number[]) => void
accent?: string
}
// Идея компонента: три панели и два разделителя. Состояние хранится не как
// ширины панелей, а как положения границ — тогда соседняя панель не может
// «съехать» вслед за чужим округлением, а ограничения превращаются в простой
// зажим границы между соседями.
const STYLES = `
:where([data-vibeui-block="resizable-002"]){
--vibeui-resizable-002-bg:oklch(1 0 0);
--vibeui-resizable-002-fg:oklch(0.22 0.014 265);
--vibeui-resizable-002-muted:oklch(0.55 0.014 265);
--vibeui-resizable-002-border:oklch(0.9 0.006 265);
--vibeui-resizable-002-surface:oklch(0.975 0.004 265);
--vibeui-resizable-002-accent:oklch(0.56 0.15 195);
--vibeui-resizable-002-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="resizable-002"]{
box-sizing:border-box;display:flex;flex-direction:column;gap:0.5rem;
width:100%;max-width:38rem;padding:0.875rem;
border:1px solid var(--vibeui-resizable-002-border);border-radius:0.875rem;
background:var(--vibeui-resizable-002-bg);color:var(--vibeui-resizable-002-fg);
font-family:var(--vibeui-resizable-002-font);
}
[data-vibeui-block="resizable-002"] *{box-sizing:border-box}
[data-vibeui-block="resizable-002"] [data-part="frame"]{
display:flex;align-items:stretch;height:10.5rem;
border:1px solid var(--vibeui-resizable-002-border);border-radius:0.75rem;overflow:hidden;
}
[data-vibeui-block="resizable-002"] [data-part="pane"]{
min-width:0;padding:0.625rem;overflow:auto;background:var(--vibeui-resizable-002-bg);
}
[data-vibeui-block="resizable-002"] [data-part="pane"][data-role="rest"]{flex:1}
[data-vibeui-block="resizable-002"] [data-part="pane"][data-role="fixed"]{flex:none}
[data-vibeui-block="resizable-002"] h3{
margin:0 0 0.3125rem;font-size:0.6875rem;font-weight:700;letter-spacing:0.04em;text-transform:uppercase;
color:var(--vibeui-resizable-002-muted);
}
[data-vibeui-block="resizable-002"] ul{list-style:none;margin:0;padding:0;display:grid;gap:0.25rem}
[data-vibeui-block="resizable-002"] li{
font-size:0.75rem;line-height:1.3;padding:0.25rem 0.375rem;border-radius:0.375rem;
background:var(--vibeui-resizable-002-surface);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;
}
[data-vibeui-block="resizable-002"] p{margin:0;font-size:0.75rem;line-height:1.5;color:var(--vibeui-resizable-002-muted)}
[data-vibeui-block="resizable-002"] [data-part="split"]{
flex:none;width:0.6875rem;position:relative;
background:var(--vibeui-resizable-002-surface);
cursor:col-resize;touch-action:none;
}
[data-vibeui-block="resizable-002"] [data-part="split"]::before{
content:"";position:absolute;inset:0 calc(50% - 0.5px);background:var(--vibeui-resizable-002-border);
transition:background-color .15s ease;
}
[data-vibeui-block="resizable-002"] [data-part="split"]:hover::before,
[data-vibeui-block="resizable-002"] [data-part="split"][data-dragging="true"]::before{
inset:0 calc(50% - 1.5px);background:var(--vibeui-resizable-002-accent);
}
[data-vibeui-block="resizable-002"] [data-part="split"]:focus-visible{
outline:2px solid var(--vibeui-resizable-002-accent);outline-offset:-2px;
}
[data-vibeui-block="resizable-002"] [data-part="status"]{
margin:0;font-size:0.75rem;color:var(--vibeui-resizable-002-muted);font-variant-numeric:tabular-nums;
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="resizable-002"] *{animation:none!important;transition:none!important}}
`
/**
* Три панели и два разделителя: состояние — положения границ, каждая
* зажата между соседями. Мышь и клавиатура равноправны. Один файл.
*/
export function Resizable002({
label = "Граница",
min = 14,
step = 3,
defaultLeft = 26,
defaultMiddle = 40,
onChange,
accent,
className,
style,
...props
}: Resizable002Props) {
const [edges, setEdges] = useState([defaultLeft, defaultLeft + defaultMiddle])
const [dragging, setDragging] = useState(-1)
const frame = useRef<HTMLDivElement>(null)
const first = useId()
const second = useId()
const third = useId()
const paneIds = [first, second, third]
const palette = {
...(accent ? { "--vibeui-resizable-002-accent": accent } : null),
...style,
} as CSSProperties
const limits = (index: number) => ({
low: index === 0 ? min : edges[0] + min,
high: index === 0 ? edges[1] - min : 100 - min,
})
const apply = (index: number, value: number) => {
const { low, high } = limits(index)
const next = [...edges]
next[index] = Math.min(high, Math.max(low, value))
setEdges(next)
onChange?.([next[0], next[1] - next[0], 100 - next[1]])
}
const onKeyDown = (event: KeyboardEvent<HTMLDivElement>, index: number) => {
const { low, high } = limits(index)
if (event.key === "ArrowLeft") {
event.preventDefault()
apply(index, edges[index] - step)
} else if (event.key === "ArrowRight") {
event.preventDefault()
apply(index, edges[index] + step)
} else if (event.key === "Home") {
event.preventDefault()
apply(index, low)
} else if (event.key === "End") {
event.preventDefault()
apply(index, high)
}
}
const widths = [edges[0], edges[1] - edges[0]]
const splitProps = (index: number) => ({
"data-part": "split",
role: "separator" as const,
tabIndex: 0,
"aria-orientation": "vertical" as const,
"aria-label": `${label} ${index + 1}`,
"aria-controls": paneIds[index],
"aria-valuenow": Math.round(edges[index]),
"aria-valuemin": Math.round(limits(index).low),
"aria-valuemax": Math.round(limits(index).high),
"data-dragging": dragging === index,
onKeyDown: (event: KeyboardEvent<HTMLDivElement>) =>
onKeyDown(event, index),
onPointerDown: (event: PointerEvent<HTMLDivElement>) => {
event.currentTarget.setPointerCapture(event.pointerId)
setDragging(index)
},
// Рамку меряем прямо в обработчике: ref читается вне рендера, иначе
// React не гарантирует, что значение соответствует показанной разметке.
onPointerMove: (event: PointerEvent<HTMLDivElement>) => {
if (dragging !== index) return
const box = frame.current?.getBoundingClientRect()
if (!box || box.width === 0) return
apply(index, ((event.clientX - box.left) / box.width) * 100)
},
onPointerUp: (event: PointerEvent<HTMLDivElement>) => {
event.currentTarget.releasePointerCapture(event.pointerId)
setDragging(-1)
},
onPointerCancel: () => setDragging(-1),
})
return (
<>
<style href="vibeui-resizable-002" precedence="medium">
{STYLES}
</style>
<div
{...props}
data-vibeui-block="resizable-002"
className={className}
style={palette}
>
<div data-part="frame" ref={frame}>
<section
data-part="pane"
data-role="fixed"
id={paneIds[0]}
style={{ width: `${widths[0]}%` }}
aria-label="Проекты"
>
<h3>Проекты</h3>
<ul>
<li>Витрина</li>
<li>Каталог</li>
<li>Документы</li>
</ul>
</section>
<div {...splitProps(0)} />
<section
data-part="pane"
data-role="fixed"
id={paneIds[1]}
style={{ width: `${widths[1]}%` }}
aria-label="Задачи"
>
<h3>Задачи</h3>
<ul>
<li>Собрать реестр</li>
<li>Проверить превью</li>
<li>Обновить документацию</li>
</ul>
</section>
<div {...splitProps(1)} />
<section
data-part="pane"
data-role="rest"
id={paneIds[2]}
aria-label="Описание"
>
<h3>Описание</h3>
<p>
Правая панель забирает остаток ширины, поэтому сумма всегда
сходится к сотне процентов без пересчёта.
</p>
</section>
</div>
<p data-part="status" role="status">
{Math.round(widths[0])}% · {Math.round(widths[1])}% ·{" "}
{Math.round(100 - edges[1])}%
</p>
</div>
</>
)
}