Overlays
VDrawer
Painel contextual slide-in que revela detalhes e ações sem tirar o usuário da página atual. Usar para detalhes, settings, filtros ou fluxos de criação mantendo o contexto. Promessa hero: "Reveal details without leaving context. A slide-in panel for every moment." Pilares: Contextual (keep users in flow without navigation), Flexible (supports multiple sizes and content), Versatile (details, forms, settings).
<script setup lang="ts">
import { VDrawer } 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 VDrawer.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, VDrawer } from 'vueui-nova-kit'
const args = {
title: 'Project details',
placement: 'right',
size: 'md',
modelValue: false
}
const isOpen = ref(false)
</script>
<template>
<VButton data-test-id="drawer-trigger-open" @click="isOpen = true">Open drawer</VButton>
<VDrawer v-bind="args" v-model="isOpen">
<p>A modern marketing website for Acme Inc.</p>
<template #footer>
<VButton variant="ghost" data-test-id="drawer-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="drawer-action-save" @click="isOpen = false">Save</VButton>
</template>
</VDrawer>
</template>Left
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDrawer } from 'vueui-nova-kit'
const args = {
title: 'Filters',
placement: 'left',
size: 'md',
modelValue: false
}
const isOpen = ref(false)
</script>
<template>
<VButton data-test-id="drawer-trigger-open" @click="isOpen = true">Open drawer</VButton>
<VDrawer v-bind="args" v-model="isOpen">
<p>A modern marketing website for Acme Inc.</p>
<template #footer>
<VButton variant="ghost" data-test-id="drawer-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="drawer-action-save" @click="isOpen = false">Save</VButton>
</template>
</VDrawer>
</template>Top
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDrawer } from 'vueui-nova-kit'
const args = {
title: 'Notifications',
placement: 'top',
size: 'md',
modelValue: false
}
const isOpen = ref(false)
</script>
<template>
<VButton data-test-id="drawer-trigger-open" @click="isOpen = true">Open drawer</VButton>
<VDrawer v-bind="args" v-model="isOpen">
<p>A modern marketing website for Acme Inc.</p>
<template #footer>
<VButton variant="ghost" data-test-id="drawer-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="drawer-action-save" @click="isOpen = false">Save</VButton>
</template>
</VDrawer>
</template>Bottom
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDrawer } from 'vueui-nova-kit'
const args = {
title: 'Quick actions',
placement: 'bottom',
size: 'md',
modelValue: false
}
const isOpen = ref(false)
</script>
<template>
<VButton data-test-id="drawer-trigger-open" @click="isOpen = true">Open drawer</VButton>
<VDrawer v-bind="args" v-model="isOpen">
<p>A modern marketing website for Acme Inc.</p>
<template #footer>
<VButton variant="ghost" data-test-id="drawer-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="drawer-action-save" @click="isOpen = false">Save</VButton>
</template>
</VDrawer>
</template>Small
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDrawer } from 'vueui-nova-kit'
const args = {
title: 'Compact drawer',
placement: 'right',
size: 'sm',
modelValue: false
}
const isOpen = ref(false)
</script>
<template>
<VButton data-test-id="drawer-trigger-open" @click="isOpen = true">Open drawer</VButton>
<VDrawer v-bind="args" v-model="isOpen">
<p>A modern marketing website for Acme Inc.</p>
<template #footer>
<VButton variant="ghost" data-test-id="drawer-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="drawer-action-save" @click="isOpen = false">Save</VButton>
</template>
</VDrawer>
</template>Large
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDrawer } from 'vueui-nova-kit'
const args = {
title: 'Complex drawer',
placement: 'right',
size: 'lg',
modelValue: false
}
const isOpen = ref(false)
</script>
<template>
<VButton data-test-id="drawer-trigger-open" @click="isOpen = true">Open drawer</VButton>
<VDrawer v-bind="args" v-model="isOpen">
<p>A modern marketing website for Acme Inc.</p>
<template #footer>
<VButton variant="ghost" data-test-id="drawer-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="drawer-action-save" @click="isOpen = false">Save</VButton>
</template>
</VDrawer>
</template>Closed
Variação Fechado. Props: modelValue=false.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VDrawer } from 'vueui-nova-kit'
const value = ref(false)
</script>
<template>
<VDrawer v-model="value" title="Project details" />
</template>Disabled
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDrawer } from 'vueui-nova-kit'
const args = {
title: 'Project details',
placement: 'right',
size: 'md',
modelValue: false,
disabled: true
}
const isOpen = ref(false)
</script>
<template>
<VButton data-test-id="drawer-trigger-open" @click="isOpen = true">Open drawer</VButton>
<VDrawer v-bind="args" v-model="isOpen">
<p>A modern marketing website for Acme Inc.</p>
<template #footer>
<VButton variant="ghost" data-test-id="drawer-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="drawer-action-save" @click="isOpen = false">Save</VButton>
</template>
</VDrawer>
</template>Loading
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDrawer } from 'vueui-nova-kit'
const args = {
title: 'Project details',
placement: 'right',
size: 'md',
modelValue: false,
loading: true
}
const isOpen = ref(false)
</script>
<template>
<VButton data-test-id="drawer-trigger-open" @click="isOpen = true">Open drawer</VButton>
<VDrawer v-bind="args" v-model="isOpen">
<p>A modern marketing website for Acme Inc.</p>
<template #footer>
<VButton variant="ghost" data-test-id="drawer-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="drawer-action-save" @click="isOpen = false">Save</VButton>
</template>
</VDrawer>
</template>Interactive
Variação Interativo. Interativo: o estado é mantido na própria story (v-model). Slots usados: #footer.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VDrawer } from 'vueui-nova-kit'
const isOpen = ref(false)
</script>
<template>
<VButton data-test-id="drawer-trigger-open" @click="isOpen = true">Try Drawer</VButton>
<VDrawer v-model="isOpen" title="Project details" placement="right" size="md">
<p>Reveal details without leaving context.</p>
<template #footer>
<VButton variant="ghost" data-test-id="drawer-action-cancel" @click="isOpen = false">Cancel</VButton>
<VButton data-test-id="drawer-action-save" @click="isOpen = false">Save</VButton>
</template>
</VDrawer>
</template>Placement Left Via Side
Variação Placement Left Via Side. Props: open=true, side="left", title="Drawer à esquerda".
Ver código
<script setup lang="ts">
import { VDrawer } from 'vueui-nova-kit'
</script>
<template>
<VDrawer v-model="value" title="Drawer à esquerda" open side="left" />
</template>Placement Top
Variação Placement Top. Props: open=true, placement="top", title="Drawer no topo".
Ver código
<script setup lang="ts">
import { VDrawer } from 'vueui-nova-kit'
</script>
<template>
<VDrawer v-model="value" title="Drawer no topo" placement="top" open />
</template>Width Large
Variação Largura grande. Props: open=true, width="lg", title="Largura lg".
Ver código
<script setup lang="ts">
import { VDrawer } from 'vueui-nova-kit'
</script>
<template>
<VDrawer v-model="value" title="Largura lg" open width="lg" />
</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 { VDrawer } from 'vueui-nova-kit'
</script>
<template>
<VDrawer
v-model="value"
title="Sem botão de fechar"
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 { VDrawer } from 'vueui-nova-kit'
</script>
<template>
<VDrawer
v-model="value"
title="Não dispensável"
open
:dismissible="false" />
</template>Acessibilidade
Semântica nativa primeiro, foco visível, labels acessíveis e teclado conforme o padrão WAI-ARIA correspondente.
Estados
Default · Hover · Focus-visible · Pressed/Active quando aplicável · Disabled · Loading quando aplicável.
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Hover | background/transform | 100ms | standard |
| Focus | outline/box-shadow | 100ms | standard |
| Enter/Exit | opacity/transform | 160ms | standard |
Respeitar prefers-reduced-motion.
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | boolean | undefined | Controlled visibility (`v-model`). |
open | boolean | undefined | Alias for `modelValue` (`v-model:open`). |
title | string | undefined | — |
placement | VDrawerPlacement | "right" | Edge the drawer slides in from (design poster default: right). |
side | VDrawerPlacement | — | Alias for `placement`. |
size | VDrawerSize | "md" | Width preset for side drawers (sm 320 / md 480 / lg 640). |
width | VDrawerSize | — | Alias for `size` from the design doc code snippet (`width="md"`). |
showClose | boolean | true | — |
dismissible | boolean | true | Backdrop click and Escape dismiss the drawer. |
disabled | boolean | false | — |
loading | boolean | false | — |
ariaLabel | string | undefined | — |
ariaDescribedby | string | undefined | — |
closeLabel | string | "Close drawer" | — |
variant | VDrawerVariant | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: boolean | — |
@update:open | value: boolean | — |
@open-change | value: boolean | — |
@close | — | — |
@dismiss | — | — |
Slots
| Slot | Props do slot |
|---|---|
#tabs | — |
#actions | — |
#default | — |
#footer | — |
Fonte: src/components/feedback/VDrawer/VDrawer.vue · tipos: src/components/feedback/VDrawer/VDrawer.types.ts