Layout e grids

VSplitView

Componente10 exemplos10 props

Workspace multi-pane ajustavel (2-3 panes: sidebar, conteudo, inspector) com divisores arrastaveis, seguindo tokens semânticos e Light Mode como referência principal.

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

Uso

Exemplo
<script setup lang="ts">

</script>

<template>
  
</template>

Playground

Os controles abaixo são gerados a partir das props declaradas em VSplitView.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 { VSplitView } from 'vueui-nova-kit'

const sizes = [280, 1, 320]
</script>

<template>
  <VSplitView :collapsible="false" :sizes="sizes" />
</template>

Two Panes

Variação Two Panes.

Ver código
vue
<script setup lang="ts">
import { VSplitView } from 'vueui-nova-kit'

const sizes = [280, 1]
</script>

<template>
  <VSplitView :collapsible="false" :sizes="sizes" />
</template>

Three Panes

Variação Three Panes.

Ver código
vue
<script setup lang="ts">
import { VSplitView } from 'vueui-nova-kit'

const sizes = [280, 1, 320]
</script>

<template>
  <VSplitView :collapsible="false" :sizes="sizes" />
</template>

Horizontal

Variação Horizontal. Props: orientation="horizontal".

Ver código
vue
<script setup lang="ts">
import { VSplitView } from 'vueui-nova-kit'

const sizes = [1, 1]
</script>

<template>
  <VSplitView orientation="horizontal" :collapsible="false" :sizes="sizes" />
</template>

Fixed

Variação Fixed. Props: mode="fixed", collapsible=false.

Ver código
vue
<script setup lang="ts">
import { VSplitView } from 'vueui-nova-kit'

const sizes = [280, 1]
</script>

<template>
  <VSplitView mode="fixed" :collapsible="false" :sizes="sizes" />
</template>

Resizable

Variação Resizable. Props: mode="resizable".

Ver código
vue
<script setup lang="ts">
import { VSplitView } from 'vueui-nova-kit'

const sizes = [280, 1]
</script>

<template>
  <VSplitView :collapsible="false" :sizes="sizes" />
</template>

Collapsible

Variação Recolhível. Props: mode="collapsible", collapsible=true.

Ver código
vue
<script setup lang="ts">
import { VSplitView } from 'vueui-nova-kit'

const sizes = [280, 1, 320]
</script>

<template>
  <VSplitView mode="collapsible" collapsible :sizes="sizes" />
</template>

Persisted

Variação Persisted. Props: persistKey="ide-layout".

Ver código
vue
<script setup lang="ts">
import { VSplitView } from 'vueui-nova-kit'

const sizes = [280, 1, 320]
</script>

<template>
  <VSplitView :collapsible="false" :sizes="sizes" persist-key="ide-layout" />
</template>

Disabled

Variação Desabilitado. Props: disabled=true.

Ver código
vue
<script setup lang="ts">
import { VSplitView } from 'vueui-nova-kit'

const sizes = [280, 1, 320]
</script>

<template>
  <VSplitView :collapsible="false" :sizes="sizes" disabled />
</template>

Default Size

Variação Padrão tamanho. Props: defaultSize=320.

Ver código
vue
<script setup lang="ts">
import { VSplitView } from 'vueui-nova-kit'

const sizes = [1, 1]
</script>

<template>
  <VSplitView :collapsible="false" :sizes="sizes" :default-size="320" />
</template>

Acessibilidade

Divisores role="separator" focaveis com aria-orientation, aria-valuemin/max/now e label "Redimensionar paineis N e N+1"; teclado: vertical Left/Right e horizontal Up/Down ajustam 24px, Home/End vao a min/max, Enter/Space recolhe; aria-expanded="false" quando colapsado; persist-key="ide-layout" salva/restaura sizes via localStorage; panes role="group" com label "Pane N de M"; ordem logica de tab entre panes; contraste para divisores/handles; aria-disabled quando fixo/desabilitado. Segue WAI-ARIA (separator).

Estados

Default (divisor border) · Hover (highlight primary) · Dragging (ativo primary) · Collapsed (pane em tamanho minimo space-12) · Disabled (opacidade state-disabled-opacity, sem interacao).

Motion

TriggerPropertyDurationEasing
Hover divisor/handlebackground/opacity100msstandard
Drag/resizegrid-template120msstandard
Collapse/expandgrid-template120msstandard
Focusoutline/box-shadow100msstandard

Respeitar prefers-reduced-motion.

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

Props

PropTipoDefaultDescrição
sizesVSplitViewSizeValue[]—Pane sizes. Numbers > 24 are px, numbers <= 24 are flex units, strings accept px/%/fr.
orientationVSplitViewOrientation"vertical"vertical = panes lado a lado (divisor vertical). horizontal = panes empilhados.
modeVSplitViewMode"resizable"fixed = sem resize; resizable = arrastar; collapsible = resizable + recolher. Default resizable.
collapsibleboolean—Mostra controle de recolher no divisor. Opt-in, default false.
persistKeystring—Chave de persistencia: salva/restaura sizes em localStorage (Pro tip spec §2/§5).
defaultSizenumber | string
string | number
280Tamanho inicial(px) usado como referencia para panes flexiveis.
minSizenumber | string
string | number
200Tamanho minimo(px) por pane.
maxSizenumber | string
string | number
600Tamanho maximo(px) por pane.
disabledbooleanfalse—
ariaLabelstring——

Events

EventoPayloadDescrição
@update:sizessizes: VSplitViewSizeValue[]—
@resizesizes: VSplitViewSizeValue[]—
@collapseindex: number—
@expandindex: number—

Slots

SlotProps do slot
#pane-1—
#start—
#pane-2—
#default—
#pane-3—
#end—
#[`pane-${index}`]—

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