GitHub

Stat Card

Card for displaying statistics with label and value

Installation

pnpm add @corew500/ui

Usage

import { StatCard } from "@corew500/ui/stat-card"

<StatCard>Content</StatCard>

Variants

statCardVariants

AxisValuesDefault
status
defaultprimarysuccesswarningdestructive
default
size
smdefaultlg
default

statCardLabelVariants

AxisValuesDefault
size
smdefaultlg
default

statCardValueVariants

AxisValuesDefault
size
smdefaultlg
default

statCardIconVariants

AxisValuesDefault
size
smdefaultlg
default
status
defaultprimarysuccesswarningdestructive
default

API Reference

Props

PropTypeDefaultDescription
label*stringThe statistic label (e.g., "Active Users")
value*enumThe numeric value to display
prefixstringOptional prefix (e.g., "$", "+")
suffixstringOptional suffix (e.g., "%", "K")
activeenumfalseWhether this card is currently active/selected
iconenumOptional icon to display
statusenumdefault
sizeenumdefault

Accessibility

Keyboard Navigation

  • - Uses button element for proper keyboard interaction
  • Focus ring visible for keyboard navigation

Screen Readers

  • aria-pressed indicates active/selected state
  • Icons use aria-hidden="true" as they're decorative

Additional

  • Disabled state prevents interaction and reduces opacity

Localization

Translatable Content

  • - Label and value text should be pre-translated
  • Prefix/suffix strings should be pre-translated

Locale-Specific Formatting

  • Number formatting should be handled by consuming application