Meter

Displays a numeric measurement within a range.

Storage Used
x
import { Meter, MeterLabel, MeterValue } from "@/components/ui/meter"
import { widths } from "@/theme/widths"

export default function MeterDemo() {
  return (
    <Meter value={24} xstyle={widths.xs}>
      <MeterLabel>Storage Used</MeterLabel>
      <MeterValue />
    </Meter>
  )
}

Installation

pnpm dlx shadcn@latest add @arene/meter

Needs the arene setup first. Also adds Progress.

Usage

import { Meter, MeterLabel, MeterValue } from "@/components/ui/meter"

;<Meter value={24}>
  <MeterLabel>Storage Used</MeterLabel>
  <MeterValue />
</Meter>

Give the meter a MeterLabel or an aria-label to name the measurement.

Anatomy

Meter renders MeterTrack and MeterIndicator after its children.

Meter
├── MeterLabel
├── MeterValue
└── MeterTrack
    └── MeterIndicator

API reference

Each part accepts its Base UI Meter props, including render, plus xstyle, className and real inline style.

Meter

PropTypeDefault
valuenumber—
minnumber0
maxnumber100
formatIntl.NumberFormatOptions—
localeIntl.LocalesArgumentruntime locale
getAriaValueText(formattedValue: string, value: number) => string—

Use format and locale to format the value. value must be a number; use Progress for indeterminate tasks.

MeterValue

PropTypeDefault
children(formattedValue: string, value: number) => ReactNode—

meterStyles

KeyWhat it is
rootWrapping label and value row
trackRounded groove
indicatorFilled bar and reduced-motion-aware width transition
labelLabel type
valueMuted, tabular number aligned to the end

Data attributes

AttributeOnEffect
data-slot="meter"rootTargets the measurement
data-slot="meter-track"trackTargets the groove
data-slot="meter-indicator"indicatorTargets the fill
data-slot="meter-label"labelTargets the label
data-slot="meter-value"valueTargets the number