Fundamentos
VBadge
Badge é um rótulo compacto para **status**, contagens e indicadores. Não é um chip de ação.
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>Uso
<VBadge>New</VBadge>
<VBadge variant="success">Active</VBadge>
<VBadge dot variant="success">Online</VBadge>
<VBadge dot variant="danger">Offline</VBadge>
<VBadge dot dotColor="#8b5cf6">Custom</VBadge>
<VBadge variant="primary" icon="crown">Pro</VBadge>Playground
Os controles abaixo são gerados a partir das props declaradas em VBadge.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. Props: variant="neutral".
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'neutral'
}
</script>
<template>
<VBadge v-bind="args">New</VBadge>
</template>Hero
Variação Hero.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;align-items:center;gap:12px;flex-wrap:wrap">
<VBadge dataTestId="badge-status-new">New</VBadge>
<VBadge dataTestId="badge-status-beta" variant="purple">Beta</VBadge>
<VBadge dataTestId="badge-status-active" variant="success">Active</VBadge>
<VBadge dataTestId="badge-status-warning" variant="warning">Warning</VBadge>
<VBadge dataTestId="badge-status-count" :count="12" />
<VBadge dataTestId="badge-status-online" dot>Online</VBadge>
<VBadge dataTestId="badge-status-pro" variant="primary" icon="crown">Pro</VBadge>
</div>
</template>Variants
Variação Variantes.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;align-items:center;gap:12px;flex-wrap:wrap">
<VBadge variant="neutral">Badge</VBadge>
<VBadge variant="success">Success</VBadge>
<VBadge variant="warning">Warning</VBadge>
<VBadge variant="danger">Danger</VBadge>
<VBadge :count="12" />
<VBadge variant="dot">Online</VBadge>
<VBadge variant="outlined">Outlined</VBadge>
</div>
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;align-items:center;gap:12px;flex-wrap:wrap">
<VBadge size="xs">XS</VBadge>
<VBadge size="sm">SM</VBadge>
<VBadge size="md">Medium</VBadge>
<VBadge size="lg">Large</VBadge>
</div>
</template>States
Variação Estados.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;align-items:center;gap:12px;flex-wrap:wrap">
<VBadge interactive>Default</VBadge>
<VBadge interactive selected>Selected</VBadge>
</div>
</template>Interactive
Variação Interativo. Props: interactive=true, ariaLabel="Toggle new status".
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'neutral',
interactive: true,
ariaLabel: 'Toggle new status'
}
</script>
<template>
<VBadge v-bind="args">New</VBadge>
</template>Removable
Variação Removable.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;align-items:center;gap:12px;flex-wrap:wrap">
<VBadge removable removeLabel="Remove Design">Design</VBadge>
<VBadge removable variant="success" removeLabel="Remove Active">Active</VBadge>
<VBadge removable variant="warning" removeLabel="Remove Warning">Warning</VBadge>
<VBadge removable variant="danger" removeLabel="Remove Critical">Critical</VBadge>
</div>
</template>Count
Variação Count. Props: count=12.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<VBadge variant="neutral" :count="12" />
</template>Count Overflow
Contadores 1, 9 e 128 (exibido como "99+"). O contador mantém pílula e largura >= altura.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;align-items:center;gap:12px;flex-wrap:wrap">
<VBadge :count="1" />
<VBadge :count="9" />
<VBadge :count="128" />
</div>
</template>Animated
Entrada animada só com animate=true. Sem a prop, o badge monta sem animação.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'success',
animate: true
}
</script>
<template>
<VBadge v-bind="args">Live</VBadge>
</template>Dot
Variação Ponto. Props: dot=true.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
const args = {
size: 'md',
variant: 'neutral',
dot: true
}
</script>
<template>
<VBadge v-bind="args">Online</VBadge>
</template>Primary
Variação Primária. Props: variant="primary", icon="crown".
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<VBadge variant="primary" icon="crown" />
</template>Outlined
Variação Outlined. Props: variant="outlined".
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<VBadge variant="outlined" />
</template>Dot Tones
Variação Ponto tons.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;flex-wrap:wrap;gap:12px">
<VBadge dot variant="success">Online</VBadge>
<VBadge dot variant="danger">Failed</VBadge>
<VBadge dot variant="warning">Pending</VBadge>
<VBadge dot variant="primary">Active</VBadge>
<VBadge dot variant="neutral">Idle</VBadge>
<VBadge dot variant="neutral" dotColor="#8b5cf6">Custom color</VBadge>
</div>
</template>Disabled
Variação Desabilitado. Props: disabled=true.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<VBadge variant="neutral" disabled />
</template>Loading
Variação Carregando. Props: loading=true.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<VBadge variant="neutral" loading />
</template>Live
Variação Live. Props: live=true, count=3.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<VBadge variant="neutral" live :count="3" />
</template>Leaving
Variação Leaving. Props: removable=true, leaving=true.
Ver código
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>
<template>
<VBadge variant="neutral" removable leaving />
</template>Acessibilidade
O estado não depende apenas de cor: o label permanece textual, count/dot usam conteúdo semântico, e os estados interativos usam button, aria-pressed, aria-disabled, aria-busy e foco visível. Use ariaLabel para labels que não estejam completos no slot.
Estados
Badges não-interativos são spans e não entram na ordem de tabulação. Com interactive, o componente usa um button nativo com hover, :focus-visible, pressed/selected, disabled e loading.
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Enter | opacity, transform: scale() | --v-motion-normal (160ms) | --v-ease-out |
| Hover / pressed | background-color, transform | --v-motion-fast (100ms) | --v-ease-standard |
| Loading | transform: rotate() | --v-motion-spin-duration | linear |
prefers-reduced-motion: reduce remove animações e transições não essenciais.
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
size | VBadgeSize | "md" | — |
variant | VBadgeVariant | — | — |
count | string | number | — | — |
dot | boolean | — | — |
dotColor | string | — | Overrides the dot color (any CSS color). Defaults to the badge tone. |
icon | string | — | — |
interactive | boolean | false | — |
removable | boolean | false | — |
leaving | boolean | false | — |
selected | boolean | undefined | — |
disabled | boolean | false | — |
loading | boolean | false | — |
ariaLabel | string | — | — |
removeLabel | string | — | — |
live | boolean | false | — |
animate | boolean | false | Plays the entrance animation on mount. Off by default. |
dataTestId | string | — | — |
removeTestId | string | — | — |
Events
| Evento | Payload | Descrição |
|---|---|---|
@click | MouseEvent | — |
@select | MouseEvent | — |
@update:selected | boolean | — |
@remove | MouseEvent | — |
Slots
| Slot | Props do slot |
|---|---|
#icon | — |
#default | — |
Fonte: src/components/feedback/VBadge/VBadge.vue · tipos: src/components/feedback/VBadge/VBadge.types.ts