Navegação · parte de VCommandPalette

VCommandItem

Componente9 exemplos12 props

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

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

<template>
  <VCommandItem
    id="open-settings"
    label="Open settings"
    icon="settings"
    shortcut="⌘," />
</template>

Selected

Variação Selected. Props: selected=true.

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

<template>
  <VCommandItem
    id="open-settings"
    label="Open settings"
    icon="settings"
    shortcut="⌘,"
    selected />
</template>

Without Shortcut

Variação Sem Shortcut. Props: label="View documentation", icon="document".

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

<template>
  <VCommandItem
    id="open-settings"
    label="View documentation"
    icon="document" />
</template>

Without Icon

Variação Sem ícone. Props: label="Plain command", shortcut="↵".

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

<template>
  <VCommandItem id="open-settings" label="Plain command" shortcut="↵" />
</template>

Disabled

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

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

<template>
  <VCommandItem
    id="open-settings"
    label="Open settings"
    icon="settings"
    shortcut="⌘,"
    disabled />
</template>

Loading

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

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

<template>
  <VCommandItem
    id="open-settings"
    label="Open settings"
    icon="settings"
    shortcut="⌘,"
    loading />
</template>

Palette List

Variação Palette List.

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

<template>
  <div role="listbox" style="width:360px;padding:8px;border:1px solid var(--v-color-border);border-radius:12px;background:var(--v-color-surface);">
    <VCommandItem id="settings" label="Open settings" icon="settings" shortcut="⌘," selected />
    <VCommandItem id="docs" label="View documentation" icon="document" shortcut="⌘D" />
    <VCommandItem id="home" label="Go to dashboard" icon="home" shortcut="⌘H" />
    <VCommandItem id="disabled" label="Disabled action" icon="moon" disabled />
  </div>
</template>

Sizes

Variação Tamanhos.

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

<template>
  <div style="display:flex;flex-direction:column;gap:4px;width:360px;">
    <VCommandItem size="sm" label="Small command" icon="search" shortcut="⌘K" />
    <VCommandItem size="md" label="Medium command" icon="search" shortcut="⌘K" selected />
    <VCommandItem size="lg" label="Large command" icon="search" shortcut="⌘K" />
  </div>
</template>

Variants

Variação Variantes.

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

<template>
  <div style="display:flex;flex-direction:column;gap:4px;width:360px;">
    <VCommandItem variant="default" label="Default item" icon="bolt" shortcut="⌘1" />
    <VCommandItem variant="primary" label="Primary accent" icon="plus" shortcut="⌘2" selected />
    <VCommandItem variant="subtle" label="Subtle item" icon="clock" shortcut="⌘3" />
  </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
idstring——
labelstring——
iconstring——
shortcutstring——
selectedbooleanfalse—
disabledbooleanfalse—
loadingbooleanfalse—
sizeVCommandItemSize"md"—
variantVCommandItemVariant"default"—
ariaLabelstring——
dataTestIdstring——
domIdstring——

Events

EventoPayloadDescrição
@clickevent: MouseEvent—
@selectpayload: { id?: string; label?: string }—

Slots

SlotProps do slot
#icon—
#default—

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