EEnterUI
DocsComponentsThemesDonation
Get Started
      • Meter
      • Gauge
      • Sparkline
EnterUIDocsData AnalyticsMetrics and ChartsScalar MetricsGauge
Data AnalyticsUpdated 6 May 2026

Gauge

Half-circle radial meter for a value within a known range, used for health scores and quota readings.

Gauge renders a value-in-range as a half-circle arc. Use it for product scores, system health, and capacity readings where a linear Meter would feel less prominent.

#Default usage

Health gauge

Renders the percentage in the centre of the arc.

68%
Health score
Code
<Gauge label="Health score" unit="%" value={68} />

#Import

Code
import { Gauge } from "@froggdesign/enter-ui-react";

#Tone

Tones

Tone shifts the fill colour without changing layout.

86%
Healthy
58%
Watch
22%
Critical

#Accessibility

Gauge exposes role="meter" with aria-valuemin, aria-valuemax, and aria-valuenow. Provide aria-label or a textual label so the value has a name.

#API

  • value: required number.
  • min / max: bounds (defaults 0–100).
  • tone: neutral (default), success, warning, error.
  • size: width in pixels (default 120).
  • unit: optional ReactNode rendered next to the value (for example "%").
  • hideValue: hides the central value readout.
  • formatValue(value, max): customise the rendered value.

#Styling

Every exported component accepts className when it renders an element. EnterUI styles use .eui-* classes and --eui-* variables mapped from FroggDesign theme tokens.

PreviousMeter
NextSparkline

On this page

  1. Default usage
  2. Import
  3. Tone
  4. Accessibility
  5. API
  6. Styling