Layout e grids
VResizablePanel
A flexible, accessible, and performant resizable panel for modern layouts. Resize with mouse, touch, or keyboard; persist via `v-model:size` + `localStorage` (Pro tip).
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
</script>Uso
<template>
<VResizablePanel
v-model:size="sidebarWidth"
orientation="vertical"
:min="200"
:max="480"
collapsible>
</VResizablePanel>
</template>Playground
Os controles abaixo são gerados a partir das props declaradas em VResizablePanel.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Variação Padrão. Estado padrão do componente; use a aba Controls para experimentar as props ao vivo.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'left',
orientation: 'vertical',
min: 200,
max: 480
}
</script>
<template>
<div style="height:320px;width:fit-content;max-width:100%">
<VResizablePanel v-bind="args" style="height:100%">
<div style="font-weight:600;margin-bottom:12px">Navigation</div>
<div style="display:grid;gap:8px;color:var(--v-color-text-muted)">
<div>Home</div>
<div>Projects</div>
<div>Tasks</div>
<div>Settings</div>
</div>
</VResizablePanel>
</div>
</template>Two Panels
Variação Two Panels.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
</script>
<template>
<div
style="display:flex;align-items:stretch;height:360px;width:100%;max-width:100%;overflow:hidden;border:1px solid var(--v-color-border);border-radius:var(--v-radius-md)"
data-test-id="docs-resizable-two-row">
<VResizablePanel
data-test-id="docs-resizable-two-left"
variant="left"
size="sm"
style="height:100%;flex-shrink:0">Left panel</VResizablePanel>
<VResizablePanel
data-test-id="docs-resizable-two-right"
variant="right"
size="sm"
style="height:100%;flex:1;min-width:0">Right panel</VResizablePanel>
</div>
</template>Left
Variação Left. Props: variant="left", size=320.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
</script>
<template>
<VResizablePanel
:size="320"
variant="left"
orientation="vertical"
:min="200"
:max="480" />
</template>Right
Variação Right. Props: variant="right", size=320.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
</script>
<template>
<VResizablePanel
:size="320"
variant="right"
orientation="vertical"
:min="200"
:max="480" />
</template>Bottom
Variação Bottom. Props: variant="bottom", orientation="horizontal", size=240.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
</script>
<template>
<VResizablePanel
:size="240"
variant="bottom"
orientation="horizontal"
:min="200"
:max="480" />
</template>Collapsible
Variação Recolhível. Props: variant="collapsible", collapsible=true, size=320.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
const args = {
size: 320,
variant: 'collapsible',
orientation: 'vertical',
min: 200,
max: 480,
collapsible: true
}
</script>
<template>
<div style="height:320px;width:fit-content;max-width:100%">
<VResizablePanel v-bind="args" style="height:100%">
<div style="font-weight:600;margin-bottom:12px">Navigation</div>
<div style="display:grid;gap:8px;color:var(--v-color-text-muted)">
<div>Home</div>
<div>Projects</div>
<div>Tasks</div>
<div>Settings</div>
</div>
</VResizablePanel>
</div>
</template>Disabled
Variação Desabilitado. Props: disabled=true.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
</script>
<template>
<VResizablePanel
variant="left"
orientation="vertical"
:min="200"
:max="480"
disabled />
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'left',
orientation: 'vertical',
min: 200,
max: 480
}
</script>
<template>
<div style="display:flex;gap:12px;align-items:stretch" data-test-id="docs-resizable-size-row"><VResizablePanel data-test-id="docs-resizable-size-240" size="sm">Small 240</VResizablePanel><VResizablePanel data-test-id="docs-resizable-size-320" size="md">Medium 320</VResizablePanel><VResizablePanel data-test-id="docs-resizable-size-480" size="lg">Large 480</VResizablePanel></div>
</template>Variants
Variação Variantes.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'left',
orientation: 'vertical',
min: 200,
max: 480
}
</script>
<template>
<div style="display:flex;gap:12px;align-items:stretch"><VResizablePanel data-test-id="docs-resizable-variant-left" variant="left" size="sm">Left</VResizablePanel><VResizablePanel data-test-id="docs-resizable-variant-right" variant="right" size="sm">Right</VResizablePanel><VResizablePanel data-test-id="docs-resizable-variant-bottom" variant="bottom" orientation="horizontal" size="sm">Bottom</VResizablePanel><VResizablePanel data-test-id="docs-resizable-variant-collapsible" variant="collapsible" collapsible size="sm">Collapsible</VResizablePanel></div>
</template>Loading
Variação Carregando. Props: loading=true.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
</script>
<template>
<VResizablePanel
variant="left"
orientation="vertical"
:min="200"
:max="480"
loading />
</template>States
Variação Estados.
Ver código
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;gap:12px;align-items:stretch;flex-wrap:wrap;min-height:280px">
<VResizablePanel data-test-id="docs-resizable-state-default" size="sm">Default</VResizablePanel>
<VResizablePanel data-test-id="docs-resizable-state-hover" size="sm" class="v-resizable-panel--state-hover">Hover</VResizablePanel>
<VResizablePanel data-test-id="docs-resizable-state-focus" size="sm" class="v-resizable-panel--state-focus">Focus</VResizablePanel>
<VResizablePanel data-test-id="docs-resizable-state-dragging" size="sm" class="v-resizable-panel--state-dragging">Dragging</VResizablePanel>
<VResizablePanel data-test-id="docs-resizable-state-collapsed" variant="collapsible" collapsible size="sm" class="v-resizable-panel--collapsed">Collapsed</VResizablePanel>
<VResizablePanel data-test-id="docs-resizable-state-disabled" size="sm" disabled>Disabled</VResizablePanel>
</div>
</template>Acessibilidade
Handle role="separator" with tabindex="0", aria-orientation, aria-valuemin/max/now + aria-valuetext; polite aria-live region (v-resizable-panel-live); collapse trigger with aria-expanded; keyboard arrows/Home/End/Enter; :focus-visible ring; reduced motion honored.
Estados
Default · Hover handle · Focus handle (:focus-visible ring) · Dragging · Collapsed · Disabled.
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Resize (programmatic/collapse) | width/height | 160ms | out |
| Drag (continuous) | width/height direct, transition: none | — | — |
| Hover/Focus | background/outline | 100ms | standard |
Respeitar prefers-reduced-motion.
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
size | VResizablePanelSize | "md" | v-model:size — largura (vertical) ou altura (horizontal) em px, ou preset sm|md|lg. |
orientation | VResizablePanelOrientation | undefined | vertical = sidebar (handle vertical); horizontal = bottom drawer (handle horizontal). |
min | number | 0 | Tamanho mínimo permitido em px (spec §2 parte 4). |
max | number | 1200 | Tamanho máximo permitido em px (spec §2 parte 5). |
collapsible | boolean | false | Exibe o trigger de colapso ‹/› (spec §2 parte 6). |
variant | VResizablePanelVariant | undefined | — |
disabled | boolean | false | — |
loading | boolean | false | — |
ariaLabel | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:size | size: number | — |
@resize | size: number | — |
@collapse | — | — |
@expand | — | — |
Slots
| Slot | Props do slot |
|---|---|
#default | — |
Fonte: src/components/containment/VResizablePanel/VResizablePanel.vue · tipos: src/components/containment/VResizablePanel/VResizablePanel.types.ts