Overlays

VContextMenu

Componentev-model6 exemplos8 props

Componente VueUI Nova para **context menu**, seguindo tokens semânticos e Light Mode como referência principal.

Importação
<script setup lang="ts">
import { VContextMenu } 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 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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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

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——
xnumber——
ynumber——
itemsVContextMenuItem[]
VDropdownMenuItem[]
——
disabledbooleanfalse—
loadingbooleanfalse—
sizeVContextMenuSize"md"—
ariaLabelstring——

Events

EventoPayloadDescrição
@update:modelValuevalue: boolean—
@update:xvalue: number—
@update:yvalue: number—
@open-changevalue: boolean—
@selectvalue: string—

Slots

SlotProps do slot
#default—
#menu—

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