Meter

Usage

import { Meter, Label } from "@devvy-ui/react";

<Label htmlFor="storage">Storage used · 45 of 100 GB</Label>
<Meter id="storage" label="Storage used" value={45} min={0} max={100} low={20} high={80} optimum={10} />

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
label / value	string / number	required	Accessible measurement name and current value.
min / max / low / high / optimum	number	0 / 1 / native thresholds	Finite bounds and qualitative thresholds.

Source ownership

Run npx @devvy-ui/cli init once in your React project, then add the source:

npx @devvy-ui/cli add meter

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

Meter.tsxREACT / TSX

import { forwardRef, type MeterHTMLAttributes } from 'react';
import { cx } from '../lib/cx';
export interface MeterProps
  extends Omit<
    MeterHTMLAttributes<HTMLMeterElement>,
    'value' | 'min' | 'max' | 'low' | 'high' | 'optimum'
  > {
  label: string;
  value: number;
  min?: number;
  max?: number;
  low?: number;
  high?: number;
  optimum?: number;
}
export const Meter = forwardRef<HTMLMeterElement, MeterProps>(function Meter(
  { label, value, min = 0, max = 1, low, high, optimum, className, ...props },
  ref,
) {
  let lower = Number.isFinite(min) ? min : 0;
  let upper = Number.isFinite(max) && max > lower ? max : lower + 1;
  if (!Number.isFinite(upper) || upper <= lower) {
    lower = 0;
    upper = 1;
  }
  const clamp = (number: number) => Math.min(upper, Math.max(lower, number));
  const safeLow = low !== undefined && Number.isFinite(low) ? clamp(low) : lower;
  const safeHigh =
    high !== undefined && Number.isFinite(high) ? Math.max(safeLow, clamp(high)) : upper;
  return (
    <meter
      aria-label={label}
      {...props}
      ref={ref}
      className={cx('dvy-meter', className)}
      min={lower}
      max={upper}
      low={safeLow}
      high={safeHigh}
      optimum={optimum !== undefined && Number.isFinite(optimum) ? clamp(optimum) : undefined}
      value={Number.isFinite(value) ? clamp(value) : lower}
    />
  );
});

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Interactive preview

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.