Feedback

Badge

Indicatore visivo compatto per notifiche, contatori e stati. Supporta severity, varianti, icone e dismissal.

Import

import { Badge } from '@pzeta/vue-components'
// oppure tramite plugin:
import { FeedbackPlugin } from '@pzeta/vue-components'
app.use(FeedbackPlugin)

Esempio Base

Props

PropTipoDefaultDescrizione
valuestring | number | nullnullValore da visualizzare nel badge
severity'primary' | 'secondary' | 'success' | 'info' | 'warn' | 'danger' | 'contrast' | 'help''primary'Severity che determina il colore
size'small' | 'medium' | 'large''medium'Dimensione del badge
variant'solid' | 'outlined' | 'subtle' | 'dot''solid'Variante visiva
roundedbooleantrueBordi arrotondati (pill)
iconstring | nullnullClasse CSS dell'icona (es. 'pi pi-check')
closablebooleanfalseMostra pulsante di chiusura
closeIconstringIcona del pulsante di chiusura (default dal config globale)
maxnumber | nullnullValore massimo: se value > max mostra "max+"

Emits

EventoPayloadDescrizione
closeEventEmesso quando l'utente clicca il pulsante di chiusura

Slot

SlotScopeDescrizione
defaultContenuto custom del badge (sostituisce la prop value)

Esempi

Varianti visive

Con icona

Closable e limite massimo

Contenuto custom via slot

Accessibilità

  • Il pulsante di chiusura ha role="button" e aria-label localizzato automaticamente.
  • Supporta navigazione da tastiera: Enter e Space attivano la chiusura.
  • La variante dot non visualizza testo: aggiungere aria-hidden="true" al badge se puramente decorativo.

TypeScript

import type { BadgeProps, BadgeEmits } from '@pzeta/vue-components'
import type { BadgeSeverity, BadgeVariant } from '@pzeta/vue-components'

// BadgeSeverity = 'primary' | 'secondary' | 'success' | 'info' | 'warn' | 'danger' | 'contrast' | 'help'
// BadgeVariant  = 'solid' | 'outlined' | 'subtle' | 'dot'