# ResizablePanels

Дві панелі з pointer resize, збереженням ширини в localStorage та доступним separator-контролем.


## Приклад


Example (app/demos/resizable-panels/ResizablePanelsBasic.vue):

```vue
<script setup lang="ts">
import { shallowRef } from 'vue'

/*
 * Некерований вживання: без v-model. Ширина живе всередині компонента,
 * тягнеться роздільником, і переживе перезавантаження сторінки завдяки
 * storage-key — саме так компонент використовується в реальних shell-ах.
 */
const touched = shallowRef(false)
</script>

<template>
  <div class="h-64 overflow-hidden rounded-overlay border border-line">
    <UiResizablePanels
      :min="25"
      :max="75"
      storage-key="tatet-ui:demo:resizable-panels"
      @change="touched = true"
    >
      <template #start>
        <div class="h-full bg-card p-4">
          <p class="font-semibold text-ink">Навігація</p>
          <p class="mt-2 text-sm text-muted">Перетягніть роздільник або використайте стрілки.</p>
          <p v-if="touched" class="mt-2 text-xs text-accent">Ширина збережена — перезавантажте сторінку.</p>
        </div>
      </template>
      <template #end>
        <div class="h-full bg-subtle p-4">
          <p class="font-semibold text-ink">Робоча область</p>
          <p class="mt-2 text-sm text-muted">Розмір панелей відновиться з localStorage.</p>
        </div>
      </template>
    </UiResizablePanels>
  </div>
</template>
```


## Роздільник-лінія

Типовий роздільник — смуга 11px з лінією посередині: її видно й легко влучити.
Для інтерфейсів, де панелі й так розділені межею (список чатів і переписка),
`separator-style="line"` лишає між ними лише лінію 1px. Зона захоплення не
зменшується — це невидима смуга 12px навколо лінії (48px на дотику), а ручка
й акцентна підсвітка з'являються на наведенні, фокусі та під час перетягування.


Example (app/demos/resizable-panels/ResizablePanelsLine.vue):

```vue
<script setup lang="ts">
/*
 * `separator-style="line"`: між панелями лише лінія 1px — так розділяють
 * список і переписку в месенджерах. Зона захоплення лишається 12px.
 */
</script>

<template>
  <div class="h-64 overflow-hidden rounded-overlay border border-line">
    <UiResizablePanels :min="25" :max="60" separator-style="line">
      <template #start>
        <div class="h-full bg-card p-4">
          <p class="font-semibold text-ink">Чати</p>
          <p class="mt-2 text-sm text-muted">Лінія замість смуги: наведіть курсор, щоб побачити ручку.</p>
        </div>
      </template>
      <template #end>
        <div class="h-full bg-subtle p-4">
          <p class="font-semibold text-ink">Переписка</p>
        </div>
      </template>
    </UiResizablePanels>
  </div>
</template>

```


## Згорнута панель

Бічну панель, яку відкривають і закривають (чат поруч із відео, інспектор
поруч із полотном), не варто виносити з компонента через `v-if`: тоді
основна панель перемонтовується, і відео чи прокрутка в ній починаються
наново. `collapsed="end"` (або `"start"`) ховає панель разом із роздільником
через `display: none`, решта займає все місце, а вміст обох лишається
змонтованим. Ширина не скидається — розгорнута панель повертається до
попередньої.


Example (app/demos/resizable-panels/ResizablePanelsCollapsed.vue):

```vue
<script setup lang="ts">
import { shallowRef } from 'vue'

/*
 * `collapsed`: бічна панель відкривається й закривається, а основна не
 * перемонтовується — лічильник у ній живе далі. Ширина бічної зберігається
 * між відкриттями.
 */
const open = shallowRef(true)
const split = shallowRef(65)
const clicks = shallowRef(0)
</script>

<template>
  <div class="h-64 overflow-hidden rounded-overlay border border-line">
    <UiResizablePanels
      :min="40"
      :max="80"
      v-model="split"
      :collapsed="open ? undefined : 'end'"
      separator-style="line"
      start-label="Основна область"
      end-label="Бічна панель"
    >
      <template #start>
        <div class="flex h-full flex-col items-start gap-3 bg-card p-4">
          <p class="font-semibold text-ink">Основна область</p>
          <p class="text-sm text-muted">Стан тут не скидається, коли бічна панель ховається.</p>
          <div class="flex flex-wrap gap-2">
            <UiButton size="sm" variant="outline" @click="clicks++">Натиснуто: {{ clicks }}</UiButton>
            <UiButton size="sm" @click="open = !open">{{ open ? 'Сховати панель' : 'Показати панель' }}</UiButton>
          </div>
        </div>
      </template>
      <template #end>
        <div class="h-full bg-subtle p-4">
          <p class="font-semibold text-ink">Бічна панель</p>
          <p class="mt-2 text-sm text-muted">Розсуньте її — після повторного відкриття ширина та сама.</p>
        </div>
      </template>
    </UiResizablePanels>
  </div>
</template>

```


## API

[Props, events, slots, exposed API (JSON)](https://ui.tatet.net/api/component-meta/UiResizablePanels)

## Коли використовувати

Для редакторів, файлових менеджерів і dashboard, де користувачу потрібно
розподіляти місце між двома одночасно важливими областями.

Збереження ширини (`storage-key`) — саме для таких екранів: оператор,
який щодня розсуває список товарів на 40%, не має робити цього двічі.
Компонент сам читає значення в `onMounted` і сам записує його після
дії користувача — батьківській сторінці не потрібно тримати ні стан,
ні власний `localStorage`-ключ.

## Коли НЕ використовувати

Не використовуйте resize, якщо одна панель є тимчасовою — тоді краще Drawer.
На вузьких екранах часто зрозуміліше скласти блоки вертикально без separator:
для цього панелям і роздільнику можна передати адаптивні класи
(`start-class`, `end-class`, `separator-class`), напр. `max-md:hidden`,
і вузький екран залишиться з одною панеллю без жодного JS.

## Збереження розміру

`storage-key` вимикає необхідність у `v-model` повністю: компонент
зберігає останню встановлену ширину і відновлює її наступного разу.

- відновлення відбувається в `onMounted` — перший (серверний) рендер дає
  дефолт, клієнтський застосовує збережене значення до першої взаємодії;
- запис — лише після дії користувача (drag або клавіатура): зміни
  `modelValue` ззовні не перезаписують збережену ширину;
- значення — голе число (частка першої панелі у відсотках), тож ключ
  версіонуйте: зміна сенсу числа вимагає нового ключа, а не парсера.

## Доступність

Роздільник має `role="separator"`, значення min/max/now і правильну
orientation. Arrow-клавіші змінюють розмір на `step`, Home та End переходять
до меж. Disabled separator вилучається з tab order.

Видимий роздільник — 11px, і пальцем у нього не влучити. На
coarse-вказівнику ціль розширює невидима смуга 45px уздовж роздільника;
вона трохи заходить на краї панелей, як і `hitAreaMargins` у
react-resizable-panels.

## Портування

Компонент не має зовнішніх залежностей і сам імпортує все з `vue` —
`onMounted` у тому числі. У проєктах без Nuxt-автоімпортів (чистий Vite,
Vitest) це різниця між «працює» і `ReferenceError`.

Корінь несе `h-full w-full`: компонент заповнює батька цілком. У flex-батьку
без цього він мірявся контентом, і права панель залишала порожній хвіст.

## Event descriptions

- `update:modelValue`: Частка першої панелі у відсотках. Емітується після drag, клавіатури та при відновленні збереженого розміру.
- `change`: Фінальне значення після keyboard або pointer дії.


[Source files, dependencies and ZIP](https://ui.tatet.net/registry/components/resizable-panels.json)
