Navegação · parte de VSidebar
VNavItem
Componente VueUI Nova para **nav item**, seguindo tokens semânticos e Light Mode como referência principal.
<script setup lang="ts">
import { VNavItem } 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 VNavItem.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 { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<VNavItem label="Dashboard" icon="home" />
</template>Active
Variação Ativo. Props: active=true, label="Dashboard", icon="home".
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<VNavItem label="Dashboard" icon="home" active />
</template>With Badge
Variação Com badge. Props: label="Projects", icon="projects", badge=12.
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<VNavItem label="Projects" icon="projects" :badge="12" />
</template>As Link
Variação Como link. Props: label="Settings", icon="settings", href="#settings", active=false. Slots usados: #settings.
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<VNavItem label="Settings" icon="settings" href="#settings" />
</template>Collapsed
Variação Recolhido. Props: label="Dashboard", icon="home", collapsed=true, ariaLabel="Dashboard".
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<VNavItem label="Dashboard" icon="home" collapsed aria-label="Dashboard" />
</template>Disabled
Variação Desabilitado. Props: label="Analytics", icon="analytics", disabled=true.
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<VNavItem label="Analytics" icon="analytics" disabled />
</template>Loading
Variação Carregando. Props: label="Integrations", icon="integrations", loading=true.
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<VNavItem label="Integrations" icon="integrations" loading />
</template>Sidebar Group
Variação Sidebar grupo.
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<nav style="display:flex;flex-direction:column;gap:4px;width:240px;padding:12px;background:var(--v-color-surface);border:1px solid var(--v-color-border);border-radius:12px;">
<VNavItem label="Dashboard" icon="home" active />
<VNavItem label="Analytics" icon="analytics" />
<VNavItem label="Projects" icon="projects" badge="3" />
<VNavItem label="Team" icon="team" />
<VNavItem label="Settings" icon="settings" variant="subtle" />
</nav>
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;flex-direction:column;gap:8px;width:240px;">
<VNavItem size="sm" label="Small item" icon="home" />
<VNavItem size="md" label="Medium item" icon="home" active />
<VNavItem size="lg" label="Large item" icon="home" />
</div>
</template>Variants
Variação Variantes.
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;flex-direction:column;gap:8px;width:240px;">
<VNavItem variant="default" label="Default" icon="home" />
<VNavItem variant="primary" label="Primary accent" icon="sparkle" />
<VNavItem variant="subtle" label="Subtle muted" icon="settings" />
</div>
</template>Badge Tone Primary
Variação Badge Tone primária. Props: label="Inbox", icon="inbox", badge=8, badgeTone="primary".
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<VNavItem label="Inbox" icon="inbox" :badge="8" badge-tone="primary" />
</template>Tag And Icon Color
Variação Tag e ícone Color. Props: label="Projeto Atlas", tag="Soon", iconColor="var(--v-color-primary)".
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<VNavItem
label="Projeto Atlas"
icon="home"
tag="Soon"
icon-color="var(--v-color-primary)" />
</template>Expandable Expanded
Variação Expandable expandido. Props: label="Produtos", icon="folder", expandable=true, expanded=true, ariaControls="submenu-produtos".
Ver código
<script setup lang="ts">
import { VNavItem } from 'vueui-nova-kit'
</script>
<template>
<VNavItem
label="Produtos"
icon="folder"
expandable
expanded
aria-controls="submenu-produtos" />
</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 |
|---|---|---|---|
label | string | — | — |
value | string | number | — | — |
href | string | — | — |
icon | string | — | — |
badge | string | number | — | — |
badgeTone | VNavItemBadgeTone | — | `primary` renders the badge as a filled primary pill. |
tag | string | — | Small muted pill after the label (e.g. "Soon"). |
iconColor | string | — | Renders the icon as a colored rounded square (any CSS color). |
ariaControls | string | — | Id of the submenu this item controls (`aria-controls`). |
active | boolean | false | — |
disabled | boolean | false | — |
loading | boolean | false | — |
collapsed | boolean | false | — |
size | VNavItemSize | "md" | — |
variant | VNavItemVariant | "default" | — |
ariaLabel | string | — | — |
dataTestId | string | — | — |
expandable | boolean | — | — |
expanded | boolean | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@click | event: MouseEvent | — |
@select | payload: { value?: string | number; href?: string } | — |
@keydown | event: KeyboardEvent | — |
Slots
| Slot | Props do slot |
|---|---|
#icon | — |
#default | — |
#trailing | — |
Fonte: src/components/navigation/VNavItem/VNavItem.vue · tipos: src/components/navigation/VNavItem/VNavItem.types.ts