Superfícies

VWindow

Componentev-model18 exemplos17 props

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.

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

Uso

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

TriggerPropertyDurationEasing
Hoverbackground/transform100msstandard
Focusoutline/box-shadow100msstandard
Open (scale 0.98→1 + fade)opacity/transform160msout
Closeopacity/transform100msin

Respeitar prefers-reduced-motion (abertura vira fade simples ou nada).

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

Props

PropTipoDefaultDescrição
titlestring——
modelValuebooleanundefined—
openbooleanundefined—
sizeVWindowSize"md"—
variantVWindowVariant"default"—
activebooleanundefined—
disabledbooleanfalse—
loadingbooleanfalse—
resizablebooleanfalse—
showActionsbooleantrue—
showTrafficLightsbooleanundefined—
showAppIconbooleanundefined—
showMinimizebooleanundefined—
showSidebarbooleanundefined—
widthnumber | string
string | number
——
heightnumber | string
string | number
——
ariaLabelstring——

Events

EventoPayloadDescrição
@update:modelValuevalue: boolean—
@close——
@minimize——
@maximize——
@resizedirection: string—

Slots

SlotProps do slot
#icon—
#title—
#sidebar—
#default—

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