VibeUI

Resizable

Clamped Sidebar

Панель с настоящими пределами в пикселях: размер зажат между минимумом и максимумом, а упор в предел показан цветом полосы и подписью, а не молчанием.

  • resizable
  • min-max
  • sidebar
  • pixels

Превью

1440pxHost theme

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

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

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

Заказ № 4821

Основная область забирает остаток ширины, поэтому меню не может выдавить содержимое за край.

Меню — 200 px

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

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

# Установка и размещение «resizable-004» (Clamped Sidebar) из VibeUI

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

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

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

## 2. Что это
Панель с настоящими пределами в пикселях: размер зажат между минимумом и максимумом, а упор в предел показан цветом полосы и подписью, а не молчанием.

Боковая панель с пределами в пикселях: размер зажат между min и max, достижение предела объявлено цветом и подписью. Один файл, ноль зависимостей.

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

<Resizable004
  label="Ширина меню"
  defaultSize={200}
  min={144}
  max={288}
/>

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

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

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

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

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

## 7. Правила
- min и max — пиксели, а не rem: при крупном системном шрифте пересчитайте их сами.
- Плашка предела появляется только на границе диапазона и исчезает при первом же шаге назад.
- Компонент не сохраняет ширину между сессиями: для этого храните значение снаружи.
- Не выносите CSS-переменные в globals.css: компонент обязан оставаться одним файлом.

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

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

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

Один файл, ноль зависимостей, палитра --vibeui-resizable-004-*. Клиентский: useState, useRef, useId. Размер хранится в пикселях, а не в процентах: меню шириной «двадцать процентов» на узком экране превращается в обрубок, а минимум в пикселях держит подписи читаемыми. aria-valuenow отдаёт то же число, что и в стиле, а aria-valuetext проговаривает единицы. Упор в предел не проглатывается: корень получает data-limit, полоса красится, рядом появляется плашка с числом — иначе перетаскивание выглядит как зависший интерфейс.

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

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

"use client"

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

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

// Идея компонента: панель с настоящими пределами в пикселях, а не в процентах.
// Меню шириной в проценты на узком экране превращается в обрубок, поэтому
// размер здесь хранится в пикселях и зажимается между min и max. Упор в предел
// не проглатывается молча: разделитель меняет цвет, а подпись называет предел.
const STYLES = `
:where([data-vibeui-block="resizable-004"]){
--vibeui-resizable-004-bg:oklch(1 0 0);
--vibeui-resizable-004-fg:oklch(0.22 0.014 265);
--vibeui-resizable-004-muted:oklch(0.55 0.014 265);
--vibeui-resizable-004-border:oklch(0.9 0.006 265);
--vibeui-resizable-004-surface:oklch(0.975 0.004 265);
--vibeui-resizable-004-accent:oklch(0.55 0.17 275);
--vibeui-resizable-004-limit:oklch(0.62 0.16 55);
--vibeui-resizable-004-font:ui-sans-serif,system-ui,-apple-system,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;
}
[data-vibeui-block="resizable-004"]{
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-004-border);border-radius:0.875rem;
background:var(--vibeui-resizable-004-bg);color:var(--vibeui-resizable-004-fg);
font-family:var(--vibeui-resizable-004-font);
}
[data-vibeui-block="resizable-004"] *{box-sizing:border-box}
[data-vibeui-block="resizable-004"] [data-part="frame"]{
display:flex;align-items:stretch;height:11rem;
border:1px solid var(--vibeui-resizable-004-border);border-radius:0.75rem;overflow:hidden;
}
[data-vibeui-block="resizable-004"] [data-part="side"]{
flex:none;min-width:0;padding:0.75rem;overflow:auto;background:var(--vibeui-resizable-004-surface);
}
[data-vibeui-block="resizable-004"] [data-part="main"]{
flex:1;min-width:0;padding:0.75rem;overflow:auto;background:var(--vibeui-resizable-004-bg);
}
[data-vibeui-block="resizable-004"] h3{margin:0 0 0.375rem;font-size:0.8125rem;font-weight:650}
[data-vibeui-block="resizable-004"] ul{list-style:none;margin:0;padding:0;display:grid;gap:0.3125rem}
[data-vibeui-block="resizable-004"] li{
font-size:0.75rem;line-height:1.3;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;
color:var(--vibeui-resizable-004-muted);
}
[data-vibeui-block="resizable-004"] p{margin:0;font-size:0.75rem;line-height:1.5;color:var(--vibeui-resizable-004-muted)}
[data-vibeui-block="resizable-004"] [data-part="split"]{
flex:none;width:0.75rem;position:relative;
background:var(--vibeui-resizable-004-surface);cursor:col-resize;touch-action:none;
}
[data-vibeui-block="resizable-004"] [data-part="split"]::before{
content:"";position:absolute;inset:0 calc(50% - 1px);border-radius:9999px;
background:var(--vibeui-resizable-004-border);
transition:background-color .15s ease;
}
[data-vibeui-block="resizable-004"] [data-part="split"]:hover::before{background:var(--vibeui-resizable-004-accent)}
[data-vibeui-block="resizable-004"] [data-part="split"]:focus-visible{
outline:2px solid var(--vibeui-resizable-004-accent);outline-offset:-2px;
}
/* Упор в предел красит полосу: без этого перетаскивание выглядит как
   зависший интерфейс — курсор едет, панель стоит. */
[data-vibeui-block="resizable-004"][data-limit="true"] [data-part="split"]::before{
background:var(--vibeui-resizable-004-limit);
}
[data-vibeui-block="resizable-004"] [data-part="status"]{
display:flex;align-items:center;gap:0.5rem;margin:0;
font-size:0.75rem;color:var(--vibeui-resizable-004-muted);font-variant-numeric:tabular-nums;
}
[data-vibeui-block="resizable-004"] [data-part="badge"]{
display:inline-flex;align-items:center;padding:0.0625rem 0.375rem;border-radius:9999px;
background:color-mix(in oklab,var(--vibeui-resizable-004-limit) 18%,white);
color:oklch(0.42 0.12 55);font-size:0.6875rem;font-weight:650;
}
@media (prefers-reduced-motion:reduce){[data-vibeui-block="resizable-004"] *{animation:none!important;transition:none!important}}
`

/**
 * Панель с пределами в пикселях: размер зажат между min и max, а упор в
 * предел показан цветом и подписью. Один файл, ноль зависимостей.
 */
export function Resizable004({
  label = "Ширина меню",
  defaultSize = 200,
  min = 144,
  max = 288,
  step = 16,
  onChange,
  accent,
  className,
  style,
  ...props
}: Resizable004Props) {
  const [size, setSize] = useState(defaultSize)
  const [dragging, setDragging] = useState(false)
  const frame = useRef<HTMLDivElement>(null)
  const sideId = useId()

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

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

    setSize(clamped)
    onChange?.(clamped)
  }

  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)
    }
  }

  const atLimit = size <= min || size >= max

  return (
    <>
      <style href="vibeui-resizable-004" precedence="medium">
        {STYLES}
      </style>
      <div
        {...props}
        data-vibeui-block="resizable-004"
        data-limit={atLimit}
        className={className}
        style={palette}
      >
        <div data-part="frame" ref={frame}>
          <nav
            data-part="side"
            id={sideId}
            style={{ width: `${size}px` }}
            aria-label="Разделы"
          >
            <h3>Разделы</h3>
            <ul>
              <li>Заказы и возвраты</li>
              <li>Склад</li>
              <li>Отчёты за период</li>
              <li>Настройки доставки</li>
            </ul>
          </nav>
          <div
            data-part="split"
            role="separator"
            tabIndex={0}
            aria-orientation="vertical"
            aria-label={label}
            aria-controls={sideId}
            aria-valuenow={size}
            aria-valuemin={min}
            aria-valuemax={max}
            aria-valuetext={`${size} пикселей`}
            data-dragging={dragging}
            onKeyDown={onKeyDown}
            onPointerDown={(event) => {
              event.currentTarget.setPointerCapture(event.pointerId)
              setDragging(true)
            }}
            onPointerMove={(event: PointerEvent<HTMLDivElement>) => {
              if (!dragging) {
                return
              }

              const box = frame.current?.getBoundingClientRect()

              if (!box) {
                return
              }

              apply(event.clientX - box.left)
            }}
            onPointerUp={(event) => {
              event.currentTarget.releasePointerCapture(event.pointerId)
              setDragging(false)
            }}
            onPointerCancel={() => setDragging(false)}
          />
          <main data-part="main">
            <h3>Заказ № 4821</h3>
            <p>
              Основная область забирает остаток ширины, поэтому меню не может
              выдавить содержимое за край.
            </p>
          </main>
        </div>
        <p data-part="status" role="status">
          Меню — {size} px
          {size <= min ? <span data-part="badge">минимум {min}</span> : null}
          {size >= max ? <span data-part="badge">максимум {max}</span> : null}
        </p>
      </div>
    </>
  )
}