Fundamentos

VBadge

Componente18 exemplos18 propsA2UI · Badge

Badge é um rótulo compacto para **status**, contagens e indicadores. Não é um chip de ação.

Importação
<script setup lang="ts">
import { VBadge } from 'vueui-nova-kit'
</script>

Uso

Exemplo
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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

TriggerPropertyDurationEasing
Enteropacity, transform: scale()--v-motion-normal (160ms)--v-ease-out
Hover / pressedbackground-color, transform--v-motion-fast (100ms)--v-ease-standard
Loadingtransform: rotate()--v-motion-spin-durationlinear

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

PropTipoDefaultDescrição
sizeVBadgeSize"md"—
variantVBadgeVariant——
countstring | number——
dotboolean——
dotColorstring—Overrides the dot color (any CSS color). Defaults to the badge tone.
iconstring——
interactivebooleanfalse—
removablebooleanfalse—
leavingbooleanfalse—
selectedbooleanundefined—
disabledbooleanfalse—
loadingbooleanfalse—
ariaLabelstring——
removeLabelstring——
livebooleanfalse—
animatebooleanfalsePlays the entrance animation on mount. Off by default.
dataTestIdstring——
removeTestIdstring——

Events

EventoPayloadDescrição
@clickMouseEvent—
@selectMouseEvent—
@update:selectedboolean—
@removeMouseEvent—

Slots

SlotProps do slot
#icon—
#default—

Fonte: src/components/feedback/VBadge/VBadge.vue · tipos: src/components/feedback/VBadge/VBadge.types.ts