Resizable

Two Panes

Две панели с перетаскиваемым разделителем, у которого мышь не единственный способ: разделитель берёт фокус, стрелки меняют размер, Home и End уводят к краям.

  • resizable
  • splitter
  • keyboard
  • panes

Превью

1440pxHost theme

Использовать с AI

  1. 1. Скопируйте ссылку.
  2. 2. Напишите агенту своими словами и вставьте её в предложение.
  3. 3. Агент откроет ссылку и поставит компонент из registry.

размести это в шапке: https://vibeui.ru/c/resizable-001

Входящие

Тяните разделитель или встаньте на него табом и жмите стрелки.

Договор на подпись

Правая панель занимает остаток: её ширина не хранится отдельно и потому не может разойтись с левой.

Левая панель — 42% ширины.

Показать полную инструкцию

То, что лежит по ссылке в развёрнутом виде. Нужна, если агент не может открыть ссылку — тогда вставьте этот текст целиком.

# Установка и размещение «resizable-001» (Two Panes) из VibeUI

## 1. Сначала установка — не пропускай, не пересоздавай
Выполни эту команду до того, как писать код:
npx shadcn@latest add https://vibeui.ru/r/resizable-001.json

Registry item: https://vibeui.ru/r/resizable-001.json
Ставится в: components/vibeui/resizable-001.tsx (точный путь следует алиасам components.json этого проекта).
npm-зависимости: нет.
Registry-зависимости: нет.

Ставь из реестра. Не пересоздавай по описанию, не подменяй похожим
компонентом из другой библиотеки и не переписывай под стиль проекта.

## 2. Что это
Две панели с перетаскиваемым разделителем, у которого мышь не единственный способ: разделитель берёт фокус, стрелки меняют размер, Home и End уводят к краям.

Две панели с разделителем, который работает мышью, пальцем и с клавиатуры: стрелки шагами, Home и End к пределам. Один файл, ноль зависимостей.

## 3. Как использовать
import { Resizable001 } from "@/components/vibeui/resizable-001"

<Resizable001
  label="Ширина списка"
  defaultSize={42}
  min={20}
  max={80}
/>

Полный список пропсов — в установленном файле.

## 4. Куда поставить
Это мелкий inline-компонент. Поставь его ровно туда, куда просил
пользователь, внутрь существующей разметки. Не создавай ради него
новую страницу, секцию или обёртку. Если на этом месте уже стоит похожий
контрол — замени его, а не добавляй второй.

Куда поставить: ___
(Эту строку заполняет пользователь. Если она осталась пустой — спроси,
а не угадывай.)

## 5. Сохранить как установлено
- локальную палитру --vibeui-resizable-001-* и не подменять её токенами вашей темы
- role="separator" с tabIndex 0 и aria-valuenow: без них размер меняется только мышью
- обработку стрелок, Home и End — это обязательная часть паттерна window splitter
- setPointerCapture: без захвата перетаскивание срывается на быстром движении
- touch-action:none на полосе, иначе на телефоне вместо тяги прокручивается страница
- широкую цель нажатия вокруг тонкой линии: в один пиксель мышью не попадают

## 6. Можно менять
- имя разделителя через label
- начальную ширину через defaultSize
- пределы через min и max, шаг клавиатуры через step
- цвет полосы и фокуса через accent

## 7. Правила
- Размер в процентах: на очень узком экране левая панель может стать бесполезно тонкой — поднимите min.
- aria-valuenow округляется до целого, поэтому объявляемое значение чуть грубее фактического.
- Содержимое панелей — пример: заменяйте его, сохраняя min-width:0, иначе панель перестанет сжиматься.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

## 8. Проверка
- рендерится без ошибок в консоли;
- выглядит так же, как превью на странице VibeUI, откуда взята ссылка;
- если нет — ты изменил что-то из раздела 5, верни как было.

Для разработчика

npx shadcn@latest add https://vibeui.ru/r/resizable-001.json
https://vibeui.ru/r/resizable-001.json

Один файл, ноль зависимостей, палитра --vibeui-resizable-001-*. Клиентский: useState, useRef на рамку и useId. Разделитель — это role="separator" с tabIndex 0, aria-orientation="vertical", aria-valuenow/min/max и aria-controls на левую панель, то есть паттерн window splitter целиком. Перетаскивание держится на setPointerCapture: события продолжают приходить, даже когда курсор ушёл за пределы полосы, а touch-action:none не даёт странице прокрутиться под пальцем. Размер хранится в процентах и применяется к левой панели, правая занимает остаток — сумма не может разъехаться.

Исходник компонента

Тот же файл, который поставит агент. Нужен, если вы предпочитаете скопировать код руками.

"use client"

import { useId, useRef, useState } from "react"
import type {
  ComponentPropsWithoutRef,
  CSSProperties,
  KeyboardEvent,
  PointerEvent,
} from "react"

export type Resizable001Props = Omit<
  ComponentPropsWithoutRef<"div">,
  "children" | "onChange"
> & {
  label?: string
  defaultSize?: number
  min?: number
  max?: number
  step?: number
  onChange?: (size: number) => void
  accent?: string
}

// Идея компонента: две панели с перетаскиваемым разделителем, у которого мышь
// — не единственный способ. Разделитель объявлен role="separator" с
// aria-valuenow и берёт фокус, поэтому размер меняется стрелками, а Home и End
// уводят его к краям. Захват указателя отдан браузеру: setPointerCapture
// продолжает слать события, даже когда курсор ушёл за пределы полосы.
const STYLES = `
:where([data-vibeui-block="resizable-001"]){
--vibeui-resizable-001-bg:oklch(1 0 0);
--vibeui-resizable-001-fg:oklch(0.22 0.014 265);
--vibeui-resizable-001-muted:oklch(0.55 0.014 265);
--vibeui-resizable-001-border:oklch(0.9 0.006 265);
--vibeui-resizable-001-surface:oklch(0.975 0.004 265);
--vibeui-resizable-001-accent:oklch(0.55 0.17 265);
--vibeui-resizable-001-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="resizable-001"]{
box-sizing:border-box;display:flex;flex-direction:column;gap:0.5rem;
width:100%;max-width:34rem;padding:0.875rem;
border:1px solid var(--vibeui-resizable-001-border);border-radius:0.875rem;
background:var(--vibeui-resizable-001-bg);color:var(--vibeui-resizable-001-fg);
font-family:var(--vibeui-resizable-001-font);
}
[data-vibeui-block="resizable-001"] *{box-sizing:border-box}
[data-vibeui-block="resizable-001"] [data-part="frame"]{
display:flex;align-items:stretch;height:11rem;
border:1px solid var(--vibeui-resizable-001-border);border-radius:0.75rem;overflow:hidden;
background:var(--vibeui-resizable-001-surface);
}
[data-vibeui-block="resizable-001"] [data-part="pane"]{
min-width:0;padding:0.75rem;overflow:auto;background:var(--vibeui-resizable-001-bg);
}
[data-vibeui-block="resizable-001"] [data-part="pane"][data-role="primary"]{flex:none}
[data-vibeui-block="resizable-001"] [data-part="pane"][data-role="rest"]{flex:1}
[data-vibeui-block="resizable-001"] h3{margin:0 0 0.375rem;font-size:0.8125rem;font-weight:650}
[data-vibeui-block="resizable-001"] p{margin:0;font-size:0.75rem;line-height:1.5;color:var(--vibeui-resizable-001-muted)}
/* Полоса-разделитель шире своей видимой линии: попасть в 1 пиксель мышью
   почти невозможно, поэтому цель нажатия — 0.75rem, а линия внутри тонкая. */
[data-vibeui-block="resizable-001"] [data-part="split"]{
flex:none;width:0.75rem;padding:0;border:0;position:relative;
background:var(--vibeui-resizable-001-surface);
cursor:col-resize;touch-action:none;
transition:background-color .15s ease;
}
[data-vibeui-block="resizable-001"] [data-part="split"]::before{
content:"";position:absolute;inset:0 calc(50% - 0.5px);
background:var(--vibeui-resizable-001-border);
}
[data-vibeui-block="resizable-001"] [data-part="split"]::after{
content:"";position:absolute;top:50%;left:50%;
width:0.1875rem;height:1.75rem;margin:-0.875rem 0 0 -0.09375rem;border-radius:9999px;
background:var(--vibeui-resizable-001-border);
}
[data-vibeui-block="resizable-001"] [data-part="split"]:hover::after,
[data-vibeui-block="resizable-001"] [data-part="split"][data-dragging="true"]::after{
background:var(--vibeui-resizable-001-accent);
}
[data-vibeui-block="resizable-001"] [data-part="split"]:focus-visible{
outline:2px solid var(--vibeui-resizable-001-accent);outline-offset:-2px;
}
[data-vibeui-block="resizable-001"] [data-part="status"]{
margin:0;font-size:0.75rem;color:var(--vibeui-resizable-001-muted);
font-variant-numeric:tabular-nums;
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="resizable-001"] *{animation:none!important;transition:none!important}}
`

/**
 * Две панели с разделителем, который работает и мышью, и с клавиатуры:
 * стрелки меняют размер, Home и End уводят к краям. Один файл.
 */
export function Resizable001({
  label = "Ширина списка",
  defaultSize = 42,
  min = 20,
  max = 80,
  step = 4,
  onChange,
  accent,
  className,
  style,
  ...props
}: Resizable001Props) {
  const [size, setSize] = useState(defaultSize)
  const [dragging, setDragging] = useState(false)
  const frame = useRef<HTMLDivElement>(null)
  const paneId = useId()

  const palette = {
    ...(accent ? { "--vibeui-resizable-001-accent": accent } : null),
    ...style,
  } as CSSProperties

  const apply = (next: number) => {
    const clamped = Math.min(max, Math.max(min, next))

    setSize(clamped)
    onChange?.(clamped)
  }

  const dragTo = (event: PointerEvent<HTMLDivElement>) => {
    const box = frame.current?.getBoundingClientRect()

    if (!box || box.width === 0) {
      return
    }

    apply(((event.clientX - box.left) / box.width) * 100)
  }

  const onKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {
    if (event.key === "ArrowLeft") {
      event.preventDefault()
      apply(size - step)
    } else if (event.key === "ArrowRight") {
      event.preventDefault()
      apply(size + step)
    } else if (event.key === "Home") {
      event.preventDefault()
      apply(min)
    } else if (event.key === "End") {
      event.preventDefault()
      apply(max)
    }
  }

  return (
    <>
      <style href="vibeui-resizable-001" precedence="medium">
        {STYLES}
      </style>
      <div
        {...props}
        data-vibeui-block="resizable-001"
        className={className}
        style={palette}
      >
        <div data-part="frame" ref={frame}>
          <section
            data-part="pane"
            data-role="primary"
            id={paneId}
            style={{ width: `${size}%` }}
            aria-label="Список писем"
          >
            <h3>Входящие</h3>
            <p>
              Тяните разделитель или встаньте на него табом и жмите стрелки.
            </p>
          </section>
          <div
            data-part="split"
            role="separator"
            tabIndex={0}
            aria-orientation="vertical"
            aria-label={label}
            aria-controls={paneId}
            aria-valuenow={Math.round(size)}
            aria-valuemin={min}
            aria-valuemax={max}
            data-dragging={dragging}
            onKeyDown={onKeyDown}
            onPointerDown={(event) => {
              event.currentTarget.setPointerCapture(event.pointerId)
              setDragging(true)
            }}
            onPointerMove={(event) => {
              if (dragging) {
                dragTo(event)
              }
            }}
            onPointerUp={(event) => {
              event.currentTarget.releasePointerCapture(event.pointerId)
              setDragging(false)
            }}
            onPointerCancel={() => setDragging(false)}
          />
          <section data-part="pane" data-role="rest" aria-label="Письмо">
            <h3>Договор на подпись</h3>
            <p>
              Правая панель занимает остаток: её ширина не хранится отдельно и
              потому не может разойтись с левой.
            </p>
          </section>
        </div>
        <p data-part="status" role="status">
          Левая панель — {Math.round(size)}% ширины.
        </p>
      </div>
    </>
  )
}