Layout e grids
VSplitView
Workspace multi-pane ajustavel (2-3 panes: sidebar, conteudo, inspector) com divisores arrastaveis, seguindo tokens semânticos e Light Mode como referência principal.
<script setup lang="ts">
import { VSplitView } from 'vueui-nova-kit'
</script>Uso
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Hover divisor/handle | background/opacity | 100ms | standard |
| Drag/resize | grid-template | 120ms | standard |
| Collapse/expand | grid-template | 120ms | standard |
| Focus | outline/box-shadow | 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 |
|---|---|---|---|
sizes | VSplitViewSizeValue[] | — | Pane sizes. Numbers > 24 are px, numbers <= 24 are flex units, strings accept px/%/fr. |
orientation | VSplitViewOrientation | "vertical" | vertical = panes lado a lado (divisor vertical). horizontal = panes empilhados. |
mode | VSplitViewMode | "resizable" | fixed = sem resize; resizable = arrastar; collapsible = resizable + recolher. Default resizable. |
collapsible | boolean | — | Mostra controle de recolher no divisor. Opt-in, default false. |
persistKey | string | — | Chave de persistencia: salva/restaura sizes em localStorage (Pro tip spec §2/§5). |
defaultSize | number | string | 280 | Tamanho inicial(px) usado como referencia para panes flexiveis. |
minSize | number | string | 200 | Tamanho minimo(px) por pane. |
maxSize | number | string | 600 | Tamanho maximo(px) por pane. |
disabled | boolean | false | — |
ariaLabel | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:sizes | sizes: VSplitViewSizeValue[] | — |
@resize | sizes: VSplitViewSizeValue[] | — |
@collapse | index: number | — |
@expand | index: number | — |
Slots
| Slot | Props 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