Overlays
VDialog
Superfície modal temporária para informação crítica, decisões e tarefas focadas. O backdrop reduz a distração e o container mantém o conteúdo, descrição e ações organizados.
<script setup lang="ts">
import { VDialog } from 'vueui-nova-kit'
</script>Uso
<VDialog v-model="isOpen" title="Turn on notifications?" description="Get notified about product updates, new features, and important activity.">
<p>Supporting content goes here.</p>
<template #actions>
<VButton variant="ghost" @click="isOpen = false">Not now</VButton>
<VButton @click="enableNotifications">Enable notifications</VButton>
</template>
</VDialog>Playground
Os controles abaixo são gerados a partir das props declaradas em VDialog.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog } from 'vueui-nova-kit'
const args = {
modelValue: false,
title: 'Dialog title',
description: 'Supporting description goes here.',
size: 'md',
variant: 'basic'
}
const isOpen = ref(true)
const triggerLabel = 'Open Dialog'
</script>
<template>
<VButton data-test-id="dialog-trigger-open" @click="isOpen = true">{{ triggerLabel }}</VButton>
<VDialog v-bind="args" v-model="isOpen">
<p>Custom content can include text, forms, or any application surface.</p>
<template #actions>
<VButton variant="ghost" data-test-id="dialog-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="dialog-action-confirm" @click="isOpen = false">Confirm</VButton>
</template>
</VDialog>
</template>Confirmation
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog } from 'vueui-nova-kit'
const args = {
modelValue: false,
title: 'Delete this project?',
description: 'This action cannot be undone. This will permanently delete “Design System” and all of its data.',
size: 'md',
variant: 'confirmation',
intent: 'destructive',
confirmText: 'Delete project'
}
const isOpen = ref(false)
const triggerLabel = 'Open confirm dialog'
</script>
<template>
<VButton data-test-id="dialog-trigger-open" @click="isOpen = true">{{ triggerLabel }}</VButton>
<VDialog v-bind="args" v-model="isOpen" @confirm="isOpen = false" />
</template>Confirmation Neutral
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog } from 'vueui-nova-kit'
const args = {
modelValue: false,
title: 'Discard changes?',
description: 'You have unsaved changes. Are you sure you want to discard them?',
size: 'md',
variant: 'confirmation',
confirmText: 'Discard',
intent: 'neutral'
}
const isOpen = ref(false)
const triggerLabel = 'Open confirm dialog'
</script>
<template>
<VButton data-test-id="dialog-trigger-open" @click="isOpen = true">{{ triggerLabel }}</VButton>
<VDialog v-bind="args" v-model="isOpen" @confirm="isOpen = false" />
</template>Confirmation Success
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog } from 'vueui-nova-kit'
const args = {
modelValue: false,
title: 'Publish changes?',
description: 'This will make your project visible to everyone on your team.',
size: 'md',
variant: 'confirmation',
confirmText: 'Publish',
intent: 'success'
}
const isOpen = ref(false)
const triggerLabel = 'Open confirm dialog'
</script>
<template>
<VButton data-test-id="dialog-trigger-open" @click="isOpen = true">{{ triggerLabel }}</VButton>
<VDialog v-bind="args" v-model="isOpen" @confirm="isOpen = false" />
</template>Alert
variant="alert": avisa algo que já aconteceu. Uma única ação (sem Cancelar), ícone de atenção.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog } from 'vueui-nova-kit'
const args = {
modelValue: false,
title: 'Connection lost',
description: 'Your changes are saved locally. Reconnect to keep syncing with your team.',
size: 'md',
variant: 'alert',
confirmText: 'Got it'
}
const isOpen = ref(false)
const triggerLabel = 'Open alert dialog'
</script>
<template>
<VButton data-test-id="dialog-trigger-open" @click="isOpen = true">{{ triggerLabel }}</VButton>
<VDialog v-bind="args" v-model="isOpen" @confirm="isOpen = false" />
</template>Form
variant="form": conteúdo com campos no corpo e as ações no slot #actions.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog, VTextInput, VTextarea } from 'vueui-nova-kit'
const isOpen = ref(false)
const name = ref('Alex Chen')
const email = ref('alex@nova.dev')
const bio = ref('')
</script>
<template>
<VButton data-test-id="dialog-trigger-open" @click="isOpen = true">Edit profile</VButton>
<VDialog v-model="isOpen" variant="form" title="Edit profile" description="Update your details before saving.">
<VTextInput v-model="name" label="Full name" />
<VTextInput v-model="email" label="Email" type="email" />
<VTextarea v-model="bio" label="Bio" placeholder="A short introduction" />
<template #actions>
<VButton variant="ghost" data-test-id="dialog-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="dialog-action-confirm" @click="isOpen = false">Save changes</VButton>
</template>
</VDialog>
</template>Fullscreen
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog } from 'vueui-nova-kit'
const args = {
modelValue: false,
title: 'Workspace',
description: 'Immersive content for complex tasks.',
size: 'md',
variant: 'fullscreen'
}
const isOpen = ref(false)
const triggerLabel = 'Open Dialog'
</script>
<template>
<VButton data-test-id="dialog-trigger-open" @click="isOpen = true">{{ triggerLabel }}</VButton>
<VDialog v-bind="args" v-model="isOpen">
<p>Custom content can include text, forms, or any application surface.</p>
<template #actions>
<VButton variant="ghost" data-test-id="dialog-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="dialog-action-confirm" @click="isOpen = false">Confirm</VButton>
</template>
</VDialog>
</template>Small
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog } from 'vueui-nova-kit'
const args = {
modelValue: false,
title: 'Dialog title',
description: 'Supporting description goes here.',
size: 'sm',
variant: 'basic'
}
const isOpen = ref(false)
const triggerLabel = 'Open Dialog'
</script>
<template>
<VButton data-test-id="dialog-trigger-open" @click="isOpen = true">{{ triggerLabel }}</VButton>
<VDialog v-bind="args" v-model="isOpen">
<p>Custom content can include text, forms, or any application surface.</p>
<template #actions>
<VButton variant="ghost" data-test-id="dialog-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="dialog-action-confirm" @click="isOpen = false">Confirm</VButton>
</template>
</VDialog>
</template>Large
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog } from 'vueui-nova-kit'
const args = {
modelValue: false,
title: 'Dialog title',
description: 'Supporting description goes here.',
size: 'lg',
variant: 'basic'
}
const isOpen = ref(false)
const triggerLabel = 'Open Dialog'
</script>
<template>
<VButton data-test-id="dialog-trigger-open" @click="isOpen = true">{{ triggerLabel }}</VButton>
<VDialog v-bind="args" v-model="isOpen">
<p>Custom content can include text, forms, or any application surface.</p>
<template #actions>
<VButton variant="ghost" data-test-id="dialog-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="dialog-action-confirm" @click="isOpen = false">Confirm</VButton>
</template>
</VDialog>
</template>Closed
Variação Fechado. Props: modelValue=false.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDialog } from 'vueui-nova-kit'
const value = ref(false)
</script>
<template>
<VDialog
v-model="value"
title="Dialog title"
description="Supporting description goes here." />
</template>Confirmation With Body
Variação Confirmation com Body. Interativo: o estado é mantido na própria story (v-model).
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog } from 'vueui-nova-kit'
const args = {
modelValue: false,
title: 'Dialog title',
description: 'Supporting description goes here.',
size: 'md',
variant: 'basic'
}
const isOpen = ref(false)
</script>
<template>
<VButton @click="isOpen = true">Open confirm dialog</VButton>
<VDialog
v-bind="args"
v-model="isOpen"
variant="confirmation"
intent="destructive"
title="Delete this project?"
confirm-text="Delete project"
@confirm="isOpen = false">
<ul>
<li>All project files will be removed.</li>
<li>Team access will be revoked.</li>
</ul>
</VDialog>
</template>Interactive
Variação Interativo. Interativo: o estado é mantido na própria story (v-model). Slots usados: #actions.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDialog } from 'vueui-nova-kit'
const isOpen = ref(false)
</script>
<template>
<div style="padding: 24px;">
<VButton data-test-id="dialog-trigger-open" @click="isOpen = true">Open Dialog</VButton>
<VDialog v-model="isOpen" title="Turn on notifications?" description="Get notified about product updates, new features, and important activity.">
<template #actions>
<VButton variant="ghost" data-test-id="dialog-action-cancel" @click="isOpen = false">Not now</VButton>
<VButton data-test-id="dialog-action-confirm" @click="isOpen = false">Enable notifications</VButton>
</template>
</VDialog>
</div>
</template>Persistent
Variação Persistent. Props: open=true, variant="confirmation", persistent=true, title="Persistente", description="Backdrop e Esc não fecham.".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDialog } from 'vueui-nova-kit'
const value = ref(false)
</script>
<template>
<VDialog
v-model="value"
title="Persistente"
description="Backdrop e Esc não fecham."
variant="confirmation"
open
persistent />
</template>No Close Button
Variação Sem Close Button. Props: open=true, showClose=false, title="Sem botão de fechar".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDialog } from 'vueui-nova-kit'
const value = ref(false)
</script>
<template>
<VDialog
v-model="value"
title="Sem botão de fechar"
description="Supporting description goes here."
open
:show-close="false" />
</template>Not Dismissible
Variação Not Dismissible. Props: open=true, dismissible=false, title="Não dispensável".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDialog } from 'vueui-nova-kit'
const value = ref(false)
</script>
<template>
<VDialog
v-model="value"
title="Não dispensável"
description="Supporting description goes here."
open
:dismissible="false" />
</template>Custom Action Texts
Variação Personalizado Action Texts. Props: open=true, variant="confirmation", cancelText="Voltar", confirmText="Publicar", title="Publicar alterações?".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDialog } from 'vueui-nova-kit'
const value = ref(false)
</script>
<template>
<VDialog
v-model="value"
title="Publicar alterações?"
description="Supporting description goes here."
variant="confirmation"
open
cancel-text="Voltar"
confirm-text="Publicar" />
</template>Acessibilidade
- Usa
role="dialog"earia-modal="true". - Liga título e descrição ao container com
aria-labelledbyearia-describedby. - Move o foco para o primeiro controle ao abrir, prende Tab/Shift+Tab e devolve o foco ao trigger ao fechar.
- Escape e backdrop respeitam
dismissible; o botão de fechar tem label configurável. - O conteúdo de ação deve manter contraste AA e usar controles nativos ou
VButton.
Estados
Estados cobertos: closed, open, hover/focus/pressed nos controles de ação fornecidos pelo slot, disabled e loading. Ações devem usar VButton para receber os tokens e estados do sistema.
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Open/close backdrop | opacity | --v-motion-normal (160ms) | --v-ease-out |
| Open/close container | opacity, transform | --v-motion-normal (160ms) | --v-ease-out |
| Close button hover/press | background-color, color, transform | --v-motion-fast / --v-motion-press | --v-ease-standard |
| Loading indicator | transform | --v-motion-spin-duration | linear |
prefers-reduced-motion: reduce removes transitions and the loading animation while preserving the centered layout.
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | boolean | undefined | Controlled visibility for the native `v-model` contract. |
open | boolean | undefined | `open` is an explicit alias for consumers that prefer `v-model:open`. |
title | string | undefined | — |
description | string | undefined | — |
showClose | boolean | true | — |
dismissible | boolean | true | Backdrop click and Escape dismiss the dialog when enabled. |
persistent | boolean | false | Prevents backdrop and Escape dismissal in confirmation mode. |
disabled | boolean | false | — |
loading | boolean | false | — |
size | VDialogSize | "md" | — |
variant | VDialogVariant | "basic" | — |
intent | VDialogIntent | "neutral" | Semantic intent for built-in confirmation actions. |
cancelText | string | "Cancel" | — |
confirmText | string | "Confirm" | — |
ariaLabel | string | undefined | — |
ariaDescribedby | string | undefined | — |
closeLabel | string | "Close dialog" | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: boolean | — |
@update:open | value: boolean | — |
@open-change | value: boolean | — |
@close | — | — |
@dismiss | — | — |
@confirm | event: MouseEvent | — |
@cancel | — | — |
Slots
| Slot | Props do slot |
|---|---|
#header | — |
#icon | — |
#title | — |
#description | — |
#default | — |
#footer | — |
#actions | — |
Fonte: src/components/feedback/VDialog/VDialog.vue · tipos: src/components/feedback/VDialog/VDialog.types.ts