Navegação · parte de VCommandPalette
VCommandItem
Componente VueUI Nova para **command item**, seguindo tokens semânticos e Light Mode como referência principal.
<script setup lang="ts">
import { VCommandItem } 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 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
<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
<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
<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
<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
<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
<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
<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
<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
<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
| 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 |
|---|---|---|---|
id | string | — | — |
label | string | — | — |
icon | string | — | — |
shortcut | string | — | — |
selected | boolean | false | — |
disabled | boolean | false | — |
loading | boolean | false | — |
size | VCommandItemSize | "md" | — |
variant | VCommandItemVariant | "default" | — |
ariaLabel | string | — | — |
dataTestId | string | — | — |
domId | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@click | event: MouseEvent | — |
@select | payload: { id?: string; label?: string } | — |
Slots
| Slot | Props do slot |
|---|---|
#icon | — |
#default | — |
Fonte: src/components/navigation/VCommandItem/VCommandItem.vue · tipos: src/components/navigation/VCommandItem/VCommandItem.types.ts