Overlays

VDrawer

Componentev-model15 exemplos15 propsA2UI · Drawer

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).

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

Uso

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

TriggerPropertyDurationEasing
Hoverbackground/transform100msstandard
Focusoutline/box-shadow100msstandard
Enter/Exitopacity/transform160msstandard

Respeitar prefers-reduced-motion.

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

Props

PropTipoDefaultDescrição
modelValuebooleanundefinedControlled visibility (`v-model`).
openbooleanundefinedAlias for `modelValue` (`v-model:open`).
titlestringundefined—
placementVDrawerPlacement"right"Edge the drawer slides in from (design poster default: right).
sideVDrawerPlacement—Alias for `placement`.
sizeVDrawerSize"md"Width preset for side drawers (sm 320 / md 480 / lg 640).
widthVDrawerSize—Alias for `size` from the design doc code snippet (`width="md"`).
showClosebooleantrue—
dismissiblebooleantrueBackdrop click and Escape dismiss the drawer.
disabledbooleanfalse—
loadingbooleanfalse—
ariaLabelstringundefined—
ariaDescribedbystringundefined—
closeLabelstring"Close drawer"—
variantVDrawerVariant——

Events

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

Slots

SlotProps do slot
#tabs—
#actions—
#default—
#footer—

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