Superfícies
VWindow
Desktop-like application container (spec `DESIGN-SPEC.md`): titlebar com semáforo macOS + app icon + título + ações, sidebar Overview/Notes/Tasks/Assets/Settings, content area, resize handle e backdrop no modal.
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>Uso
<Window v-model:open="open" title="Project Notes" :width="960" :height="640">
<template #default>
<p class="text-slate-600">Your content goes here.</p>
</template>
</Window>Playground
Os controles abaixo são gerados a partir das props declaradas em VWindow.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 { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640" />
</template>Project Notes
Variação Project Notes. Props: title="Project Notes", active=true, resizable=true, width=960, height=640.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640" />
</template>Minimal
Variação Minimal. Props: variant="minimal".
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
variant="minimal"
title="Project Notes"
active
resizable
:width="960"
:height="640" />
</template>Borderless
Variação Borderless. Props: variant="borderless".
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
variant="borderless"
title="Project Notes"
active
resizable
:width="960"
:height="640" />
</template>Modal
Variação Modal. Props: variant="modal".
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
variant="modal"
title="Project Notes"
active
resizable
:width="960"
:height="640" />
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
title: 'Project Notes',
active: true,
resizable: true,
width: 960,
height: 640
}
</script>
<template>
<div style="display: grid; gap: 16px;">
<VWindow v-bind="args" size="sm" title="Small — 640 × 480" :width="640" :height="480" />
<VWindow v-bind="args" size="md" title="Medium (default) — 960 × 640" :width="960" :height="640" />
<VWindow v-bind="args" size="lg" title="Large — 1280 × 800" :width="1280" :height="800" />
</div>
</template>Active
Variação Ativo. Props: active=true.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640" />
</template>Inactive
Variação Inactive. Props: active=false.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
:active="false"
resizable
:width="960"
:height="640" />
</template>Disabled
Variação Desabilitado. Props: disabled=true.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640"
disabled />
</template>Loading
Variação Carregando. Props: loading=true.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640"
loading />
</template>With Sidebar
Variação Com Sidebar. Props: title="Project Notes", active=true, resizable=true.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640" />
</template>Modal Dismiss
Variação Modal Dismiss. Props: variant="modal", title="Project Notes".
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
variant="modal"
title="Project Notes"
active
resizable
:width="960"
:height="640" />
</template>No Actions
Variação Sem ações. Props: showActions=false.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640"
:show-actions="false" />
</template>No Traffic Lights
Variação Sem Traffic Lights. Props: showTrafficLights=false.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640"
:show-traffic-lights="false" />
</template>No App Icon
Variação Sem App ícone. Props: showAppIcon=false.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640"
:show-app-icon="false" />
</template>No Minimize
Variação Sem Minimize. Props: showMinimize=false.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640"
:show-minimize="false" />
</template>No Sidebar
Variação Sem Sidebar. Props: showSidebar=false.
Ver código
<script setup lang="ts">
import { VWindow } from 'vueui-nova-kit'
</script>
<template>
<VWindow
v-model="value"
title="Project Notes"
active
resizable
:width="960"
:height="640"
:show-sidebar="false" />
</template>Controlled Open
Visibilidade controlada com v-model: o botão fechar da janela atualiza o ref.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VWindow, VButton } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'default',
title: 'Project Notes',
active: true,
resizable: true,
width: 960,
height: 640
}
const open = ref(true)
</script>
<template>
<div style="display:grid;gap:12px"><VWindow v-bind="args" v-model="open">Conteúdo da janela</VWindow><VButton variant="outline" @click="open = true">Reabrir (open = {{ open }})</VButton></div>
</template>Acessibilidade
role="dialog" + aria-modal no modal (senão role="region"), título/label acessível, Tab percorre controles, Esc fecha, setas redimensionam, foco visível, focus trap no modal com retorno ao trigger, estrutura screen-reader friendly.
Estados
Default · Active/Inactive · Hover · Focus-visible · Pressed · Disabled · Loading · Modal com backdrop.
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Hover | background/transform | 100ms | standard |
| Focus | outline/box-shadow | 100ms | standard |
| Open (scale 0.98→1 + fade) | opacity/transform | 160ms | out |
| Close | opacity/transform | 100ms | in |
Respeitar prefers-reduced-motion (abertura vira fade simples ou nada).
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
title | string | — | — |
modelValue | boolean | undefined | — |
open | boolean | undefined | — |
size | VWindowSize | "md" | — |
variant | VWindowVariant | "default" | — |
active | boolean | undefined | — |
disabled | boolean | false | — |
loading | boolean | false | — |
resizable | boolean | false | — |
showActions | boolean | true | — |
showTrafficLights | boolean | undefined | — |
showAppIcon | boolean | undefined | — |
showMinimize | boolean | undefined | — |
showSidebar | boolean | undefined | — |
width | number | string | — | — |
height | number | string | — | — |
ariaLabel | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: boolean | — |
@close | — | — |
@minimize | — | — |
@maximize | — | — |
@resize | direction: string | — |
Slots
| Slot | Props do slot |
|---|---|
#icon | — |
#title | — |
#sidebar | — |
#default | — |
Fonte: src/components/containment/VWindow/VWindow.vue · tipos: src/components/containment/VWindow/VWindow.types.ts