Navegação · parte de VSidebar

VNavItem

Componente13 exemplos19 props

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

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

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
labelstring——
valuestring | number——
hrefstring——
iconstring——
badgestring | number——
badgeToneVNavItemBadgeTone—`primary` renders the badge as a filled primary pill.
tagstring—Small muted pill after the label (e.g. "Soon").
iconColorstring—Renders the icon as a colored rounded square (any CSS color).
ariaControlsstring—Id of the submenu this item controls (`aria-controls`).
activebooleanfalse—
disabledbooleanfalse—
loadingbooleanfalse—
collapsedbooleanfalse—
sizeVNavItemSize"md"—
variantVNavItemVariant"default"—
ariaLabelstring——
dataTestIdstring——
expandableboolean——
expandedboolean——

Events

EventoPayloadDescrição
@clickevent: MouseEvent—
@selectpayload: { value?: string | number; href?: string }—
@keydownevent: KeyboardEvent—

Slots

SlotProps do slot
#icon—
#default—
#trailing—

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