Seleção e menus
VDropdownMenu
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).
<script setup lang="ts">
import { VDropdownMenu } 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 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
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
<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
| 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 | — | — |
value | string | — | — |
label | string | — | — |
icon | string | — | — |
showTriggerIcon | boolean | true | — |
showChevron | boolean | true | — |
items | VDropdownMenuItem[] | — | — |
disabled | boolean | false | — |
loading | boolean | false | — |
size | VDropdownMenuSize | "md" | — |
variant | VDropdownMenuVariant | 'default' | 'subtle' | "secondary" | — |
triggerStyle | VDropdownMenuTriggerStyle | — | — |
menuAlign | VDropdownMenuMenuAlign | — | — |
ariaLabel | string | — | — |
teleport | boolean | true | Renderiza o painel em `document.body` (fora de overflow/z-index do pai). Default true. |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: boolean | — |
@update:value | value: string | — |
@open-change | value: boolean | — |
@select | value: string | — |
Slots
| Slot | Props do slot |
|---|---|
#trigger | is-opentoggleattrsbind-ref |
#default | — |
Fonte: src/components/navigation/VDropdownMenu/VDropdownMenu.vue · tipos: src/components/navigation/VDropdownMenu/VDropdownMenu.types.ts