Layout e grids

VResizablePanel

Componente11 exemplos9 props

A flexible, accessible, and performant resizable panel for modern layouts. Resize with mouse, touch, or keyboard; persist via `v-model:size` + `localStorage` (Pro tip).

Importação
<script setup lang="ts">
import { VResizablePanel } from 'vueui-nova-kit'
</script>

Uso

Exemplo
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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

TriggerPropertyDurationEasing
Resize (programmatic/collapse)width/height160msout
Drag (continuous)width/height direct, transition: none——
Hover/Focusbackground/outline100msstandard

Respeitar prefers-reduced-motion.

Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.

Props

PropTipoDefaultDescrição
sizeVResizablePanelSize"md"v-model:size — largura (vertical) ou altura (horizontal) em px, ou preset sm|md|lg.
orientationVResizablePanelOrientationundefinedvertical = sidebar (handle vertical); horizontal = bottom drawer (handle horizontal).
minnumber0Tamanho mínimo permitido em px (spec §2 parte 4).
maxnumber1200Tamanho máximo permitido em px (spec §2 parte 5).
collapsiblebooleanfalseExibe o trigger de colapso ‹/› (spec §2 parte 6).
variantVResizablePanelVariantundefined—
disabledbooleanfalse—
loadingbooleanfalse—
ariaLabelstring——

Events

EventoPayloadDescrição
@update:sizesize: number—
@resizesize: number—
@collapse——
@expand——

Slots

SlotProps do slot
#default—

Fonte: src/components/containment/VResizablePanel/VResizablePanel.vue · tipos: src/components/containment/VResizablePanel/VResizablePanel.types.ts