Overlays

VDialog

Componentev-model16 exemplos17 propsA2UI · Modal

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.

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

Uso

Exemplo
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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" e aria-modal="true".
  • Liga título e descrição ao container com aria-labelledby e aria-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

TriggerPropertyDurationEasing
Open/close backdropopacity--v-motion-normal (160ms)--v-ease-out
Open/close containeropacity, transform--v-motion-normal (160ms)--v-ease-out
Close button hover/pressbackground-color, color, transform--v-motion-fast / --v-motion-press--v-ease-standard
Loading indicatortransform--v-motion-spin-durationlinear

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

PropTipoDefaultDescrição
modelValuebooleanundefinedControlled visibility for the native `v-model` contract.
openbooleanundefined`open` is an explicit alias for consumers that prefer `v-model:open`.
titlestringundefined—
descriptionstringundefined—
showClosebooleantrue—
dismissiblebooleantrueBackdrop click and Escape dismiss the dialog when enabled.
persistentbooleanfalsePrevents backdrop and Escape dismissal in confirmation mode.
disabledbooleanfalse—
loadingbooleanfalse—
sizeVDialogSize"md"—
variantVDialogVariant"basic"—
intentVDialogIntent"neutral"Semantic intent for built-in confirmation actions.
cancelTextstring"Cancel"—
confirmTextstring"Confirm"—
ariaLabelstringundefined—
ariaDescribedbystringundefined—
closeLabelstring"Close dialog"—

Events

EventoPayloadDescrição
@update:modelValuevalue: boolean—
@update:openvalue: boolean—
@open-changevalue: boolean—
@close——
@dismiss——
@confirmevent: MouseEvent—
@cancel——

Slots

SlotProps do slot
#header—
#icon—
#title—
#description—
#default—
#footer—
#actions—

Fonte: src/components/feedback/VDialog/VDialog.vue · tipos: src/components/feedback/VDialog/VDialog.types.ts