Overlays
VContextMenu
Componente VueUI Nova para **context menu**, seguindo tokens semânticos e Light Mode como referência principal.
<script setup lang="ts">
import { VContextMenu } 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 VContextMenu.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 { VContextMenu } from 'vueui-nova-kit'
const args = {
size: 'md',
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>
<VContextMenu v-bind="args">
<div style="padding: 48px; border: 1px dashed var(--v-color-border); border-radius: 8px; user-select: none;">
Clique com o botão direito aqui
</div>
</VContextMenu>
</template>With Icons
Variação Com ícones.
Ver código
<script setup lang="ts">
import { VContextMenu } from 'vueui-nova-kit'
const args = {
size: 'md',
items: [
{
value: 'view',
label: 'View details',
icon: 'eye'
},
{
value: 'edit',
label: 'Edit',
icon: 'edit'
},
{
value: 'share',
label: 'Share',
icon: 'share'
},
{
value: 'divider',
label: '',
divider: true
},
{
value: 'delete',
label: 'Delete',
icon: 'trash',
destructive: true
}
]
}
</script>
<template>
<VContextMenu v-bind="args">
<div style="padding: 48px; border: 1px dashed var(--v-color-border); border-radius: 8px; user-select: none;">
Clique com o botão direito aqui
</div>
</VContextMenu>
</template>Nested
Variação Aninhado.
Ver código
<script setup lang="ts">
import { VContextMenu } from 'vueui-nova-kit'
const args = {
size: 'md',
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>
<VContextMenu v-bind="args">
<div style="padding: 48px; border: 1px dashed var(--v-color-border); border-radius: 8px; user-select: none;">
Clique com o botão direito aqui
</div>
</VContextMenu>
</template>Disabled
Variação Desabilitado. Props: disabled=true.
Ver código
<script setup lang="ts">
import { VContextMenu } from 'vueui-nova-kit'
const args = {
size: 'md',
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
}
],
disabled: true
}
</script>
<template>
<VContextMenu v-bind="args">
<div style="padding: 48px; border: 1px dashed var(--v-color-border); border-radius: 8px; user-select: none;">
Clique com o botão direito aqui
</div>
</VContextMenu>
</template>Loading
Variação Carregando. Props: loading=true.
Ver código
<script setup lang="ts">
import { VContextMenu } from 'vueui-nova-kit'
const args = {
size: 'md',
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
}
],
loading: true
}
</script>
<template>
<VContextMenu v-bind="args">
<div style="padding: 48px; border: 1px dashed var(--v-color-border); border-radius: 8px; user-select: none;">
Clique com o botão direito aqui
</div>
</VContextMenu>
</template>Interactive
Variação Interativo. Interativo: o estado é mantido na própria story (v-model).
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VButton, VContextMenu } from 'vueui-nova-kit'
const args = {
size: 'md',
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 x = ref(0)
const y = ref(0)
const lastAction = ref('—')
const onSelect = (value) => {
lastAction.value = `Selected: ${value}`;
}
const openProgrammatically = () => {
x.value = 120;
y.value = 120;
open.value = true;
}
</script>
<template>
<div style="display: grid; gap: 16px;">
<VButton variant="secondary" @click="openProgrammatically">Abrir menu programaticamente</VButton>
<p>Última ação: {{ lastAction }}</p>
<VContextMenu
v-bind="args"
v-model="open"
:x="x"
:y="y"
@select="onSelect">
<div style="padding: 48px; border: 1px dashed var(--v-color-border); border-radius: 8px;">
Área com clique direito ou use o botão acima
</div>
</VContextMenu>
</div>
</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 | — | — |
x | number | — | — |
y | number | — | — |
items | VContextMenuItem[] | — | — |
disabled | boolean | false | — |
loading | boolean | false | — |
size | VContextMenuSize | "md" | — |
ariaLabel | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: boolean | — |
@update:x | value: number | — |
@update:y | value: number | — |
@open-change | value: boolean | — |
@select | value: string | — |
Slots
| Slot | Props do slot |
|---|---|
#default | — |
#menu | — |
Fonte: src/components/navigation/VContextMenu/VContextMenu.vue · tipos: src/components/navigation/VContextMenu/VContextMenu.types.ts