Seleção e menus

VDropdownMenu

Componentev-model18 exemplos15 propsA2UI · DropdownMenu

Lista de ações e navegação compacta ("Action list and compact navigation"): acesso a ações/links a partir de um único gatilho, mantendo a interface limpa e focada. Título do hero: "PRIMARY EXAMPLE — Small menu. Fast actions. Everything you need, right where you need it." Atributos: **Flexible** (ações, links e menus aninhados), **Accessible** (keyboard friendly, screen reader ready), **Modern** (limpo, consistente).

Importação
<script setup lang="ts">
import { VDropdownMenu } 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 VDropdownMenu.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 { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu v-model="value" label="More options" :items="items" />
</template>

Primary

Variação Primária. Props: variant="primary".

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    variant="primary"
    label="More options"
    :items="items" />
</template>

Ghost

Variação Ghost. Props: variant="ghost".

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    variant="ghost"
    label="More options"
    :items="items" />
</template>

Destructive

Variação Destrutiva. Props: variant="destructive".

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    variant="destructive"
    label="More options"
    :items="items" />
</template>

Small

Variação Pequeno. Props: size="sm".

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    size="sm"
    label="More options"
    :items="items" />
</template>

Large

Variação Grande. Props: size="lg".

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    size="lg"
    label="More options"
    :items="items" />
</template>

Disabled

Variação Desabilitado. Props: disabled=true.

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    label="More options"
    :items="items"
    disabled />
</template>

Loading

Variação Carregando. Props: loading=true.

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    label="More options"
    :items="items"
    loading />
</template>

Trigger Style Field

Variação Trigger Style Field. Props: triggerStyle="field", label="Selecione…", value="edit".

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    label="Selecione…"
    :items="items"
    trigger-style="field"
    value="edit" />
</template>

Menu Align End

Variação Menu Align End. Props: menuAlign="end", label="Alinhado ao fim".

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    label="Alinhado ao fim"
    :items="items"
    menu-align="end" />
</template>

No Chevron

Variação Sem chevron. Props: showChevron=false, label="Sem chevron".

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    label="Sem chevron"
    :items="items"
    :show-chevron="false" />
</template>

No Trigger Icon

Variação Sem Trigger ícone. Props: showTriggerIcon=false, label="Sem ícone".

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'view', label: 'View details', icon: 'eye' },
  {
    value: 'share',
    label: 'Share',
    icon: 'share',
    children: [
      { value: 'copy-link', label: 'Copy link', icon: 'link' },
      { value: 'slack', label: 'Share to Slack', icon: 'slack' },
      { value: 'email', label: 'Share to email', icon: 'email' },
    ],
  },
  { value: 'rename', label: 'Rename', icon: 'edit' },
  {
    value: 'duplicate',
    label: 'Duplicate',
    icon: 'duplicate',
  },
  { value: 'divider-delete', label: '', divider: true },
  {
    value: 'delete',
    label: 'Delete',
    icon: 'trash',
    destructive: true,
  },
]
</script>

<template>
  <VDropdownMenu
    v-model="value"
    label="Sem ícone"
    :items="items"
    :show-trigger-icon="false" />
</template>

Account Menu

Menu de conta com ícones, divisor e item destrutivo ao final. Use variant="ghost" para gatilhos discretos em barras de navegação.

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const args = {
  size: 'md',
  variant: 'ghost',
  label: 'Walder Filho',
  items: [
    {
      value: 'profile',
      label: 'Meu perfil',
      icon: 'eye'
    },
    {
      value: 'edit',
      label: 'Editar conta',
      icon: 'edit'
    },
    {
      value: 'invite',
      label: 'Convidar por e-mail',
      icon: 'email'
    },
    {
      value: 'billing',
      label: 'Cobrança',
      icon: 'link',
      disabled: true
    },
    {
      value: 'div',
      label: '',
      divider: true
    },
    {
      value: 'logout',
      label: 'Excluir conta',
      icon: 'trash',
      destructive: true
    }
  ],
  showTriggerIcon: false
}
</script>

<template>
  <div style="min-height:300px;padding:8px"><VDropdownMenu v-bind="args" /></div>
</template>

Row Actions

Ações de linha de tabela: gatilho apenas com ícone (triggerStyle="icon"), submenu em "Compartilhar" e exclusão destrutiva separada por divisor.

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const args = {
  size: 'md',
  variant: 'ghost',
  label: 'Ações da linha',
  items: [
    {
      value: 'view',
      label: 'View details',
      icon: 'eye'
    },
    {
      value: 'share',
      label: 'Share',
      icon: 'share',
      children: [
        {
          value: 'copy-link',
          label: 'Copy link',
          icon: 'link'
        },
        {
          value: 'slack',
          label: 'Share to Slack',
          icon: 'slack'
        },
        {
          value: 'email',
          label: 'Share to email',
          icon: 'email'
        }
      ]
    },
    {
      value: 'rename',
      label: 'Rename',
      icon: 'edit'
    },
    {
      value: 'duplicate',
      label: 'Duplicate',
      icon: 'duplicate'
    },
    {
      value: 'divider-delete',
      label: '',
      divider: true
    },
    {
      value: 'delete',
      label: 'Delete',
      icon: 'trash',
      destructive: true
    }
  ],
  triggerStyle: 'icon',
  ariaLabel: 'Ações da linha',
  menuAlign: 'end'
}
</script>

<template>
  <div style="min-height:300px;padding:8px;display:flex;justify-content:flex-end;width:320px"><VDropdownMenu v-bind="args" /></div>
</template>

Selection Menu

Menu de seleção única: o item escolhido recebe destaque e marca de check; v-model:value mantém o valor atual.

Ver código
vue
<script setup lang="ts">
import { ref } from 'vue'
import { VDropdownMenu } from 'vueui-nova-kit'

const args = {
  size: 'md',
  variant: 'secondary',
  label: 'More options',
  items: [
    {
      value: 'view',
      label: 'View details',
      icon: 'eye'
    },
    {
      value: 'share',
      label: 'Share',
      icon: 'share',
      children: [
        {
          value: 'copy-link',
          label: 'Copy link',
          icon: 'link'
        },
        {
          value: 'slack',
          label: 'Share to Slack',
          icon: 'slack'
        },
        {
          value: 'email',
          label: 'Share to email',
          icon: 'email'
        }
      ]
    },
    {
      value: 'rename',
      label: 'Rename',
      icon: 'edit'
    },
    {
      value: 'duplicate',
      label: 'Duplicate',
      icon: 'duplicate'
    },
    {
      value: 'divider-delete',
      label: '',
      divider: true
    },
    {
      value: 'delete',
      label: 'Delete',
      icon: 'trash',
      destructive: true
    }
  ]
}
const value = ref('recent')
const items = [
  {
    value: 'recent',
    label: 'Mais recentes'
  },
  {
    value: 'oldest',
    label: 'Mais antigos'
  },
  {
    value: 'name',
    label: 'Nome (A-Z)'
  },
  {
    value: 'size',
    label: 'Tamanho'
  }
]
</script>

<template>
  <div style="min-height:300px;padding:8px"><VDropdownMenu v-bind="args" label="Ordenar por" v-model:value="value" :items="items" :show-trigger-icon="false" /></div>
</template>

Controlled Open And Value

Abertura e valor controlados: v-model (aberto) e v-model:value (item escolhido). O estado atual é exibido abaixo apenas para demonstração.

Ver código
vue
<script setup lang="ts">
import { ref } from 'vue'
import { VDropdownMenu } from 'vueui-nova-kit'

const args = {
  size: 'md',
  variant: 'secondary',
  label: 'More options',
  items: [
    {
      value: 'view',
      label: 'View details',
      icon: 'eye'
    },
    {
      value: 'share',
      label: 'Share',
      icon: 'share',
      children: [
        {
          value: 'copy-link',
          label: 'Copy link',
          icon: 'link'
        },
        {
          value: 'slack',
          label: 'Share to Slack',
          icon: 'slack'
        },
        {
          value: 'email',
          label: 'Share to email',
          icon: 'email'
        }
      ]
    },
    {
      value: 'rename',
      label: 'Rename',
      icon: 'edit'
    },
    {
      value: 'duplicate',
      label: 'Duplicate',
      icon: 'duplicate'
    },
    {
      value: 'divider-delete',
      label: '',
      divider: true
    },
    {
      value: 'delete',
      label: 'Delete',
      icon: 'trash',
      destructive: true
    }
  ]
}
const open = ref(false)
const value = ref('')
</script>

<template>
  <div style="min-height:300px;padding:8px"><VDropdownMenu v-bind="args" v-model="open" v-model:value="value" label="Ações" /></div>
</template>

Inside Overflow Hidden

Gatilho dentro de um contêiner com overflow: hidden e altura curta. O painel é teleportado para body, então não é recortado. Props: teleport (default true).

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const args = {
  size: 'md',
  variant: 'secondary',
  label: 'Dentro de overflow hidden',
  items: [
    {
      value: 'view',
      label: 'View details',
      icon: 'eye'
    },
    {
      value: 'share',
      label: 'Share',
      icon: 'share',
      children: [
        {
          value: 'copy-link',
          label: 'Copy link',
          icon: 'link'
        },
        {
          value: 'slack',
          label: 'Share to Slack',
          icon: 'slack'
        },
        {
          value: 'email',
          label: 'Share to email',
          icon: 'email'
        }
      ]
    },
    {
      value: 'rename',
      label: 'Rename',
      icon: 'edit'
    },
    {
      value: 'duplicate',
      label: 'Duplicate',
      icon: 'duplicate'
    },
    {
      value: 'divider-delete',
      label: '',
      divider: true
    },
    {
      value: 'delete',
      label: 'Delete',
      icon: 'trash',
      destructive: true
    }
  ]
}
</script>

<template>
  <div style="height:96px;width:280px;overflow:hidden;padding:8px;border:1px dashed var(--v-color-border)"><VDropdownMenu v-bind="args" /></div>
</template>

Many Items

Lista longa com mais de 15 itens. O painel rola internamente (overflow padrão do overlay) e não ultrapassa a viewport. Props: items com 20 entradas.

Ver código
vue
<script setup lang="ts">
import { VDropdownMenu } from 'vueui-nova-kit'

const items = [
  { value: 'item-1', label: 'Item 1' },
  { value: 'item-2', label: 'Item 2' },
  { value: 'item-3', label: 'Item 3' },
  { value: 'item-4', label: 'Item 4' },
  { value: 'item-5', label: 'Item 5' },
  { value: 'item-6', label: 'Item 6' },
  { value: 'item-7', label: 'Item 7' },
  { value: 'item-8', label: 'Item 8' },
  { value: 'item-9', label: 'Item 9' },
  { value: 'item-10', label: 'Item 10' },
  { value: 'item-11', label: 'Item 11' },
  { value: 'item-12', label: 'Item 12' },
  { value: 'item-13', label: 'Item 13' },
  { value: 'item-14', label: 'Item 14' },
  { value: 'item-15', label: 'Item 15' },
  { value: 'item-16', label: 'Item 16' },
  { value: 'item-17', label: 'Item 17' },
  { value: 'item-18', label: 'Item 18' },
  { value: 'item-19', label: 'Item 19' },
  { value: 'item-20', label: 'Item 20' },
]
</script>

<template>
  <VDropdownMenu v-model="value" label="Muitos itens" :items="items" />
</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
modelValueboolean——
valuestring——
labelstring——
iconstring——
showTriggerIconbooleantrue—
showChevronbooleantrue—
itemsVDropdownMenuItem[]——
disabledbooleanfalse—
loadingbooleanfalse—
sizeVDropdownMenuSize"md"—
variantVDropdownMenuVariant | 'default' | 'subtle'
"default" | "subtle" | VDropdownMenuVariant
"secondary"—
triggerStyleVDropdownMenuTriggerStyle——
menuAlignVDropdownMenuMenuAlign——
ariaLabelstring——
teleportbooleantrueRenderiza o painel em `document.body` (fora de overflow/z-index do pai). Default true.

Events

EventoPayloadDescrição
@update:modelValuevalue: boolean—
@update:valuevalue: string—
@open-changevalue: boolean—
@selectvalue: string—

Slots

SlotProps do slot
#triggeris-opentoggleattrsbind-ref
#default—

Fonte: src/components/navigation/VDropdownMenu/VDropdownMenu.vue · tipos: src/components/navigation/VDropdownMenu/VDropdownMenu.types.ts