data
Radial Meter
A restrained semantic circular value display with optional segments.
- data
- meter
- progress
- svg
Live preview
Quick usage
import { RadialMeter } from "@pinky-ui/systems";
<RadialMeter value={67} label="Completion" />Presets
Default
Restrained production behaviour.
Default behaviour
Quiet
Reduced intensity for dense product screens.
disabled={true}
Install
Add @pinky-ui/systems as a dependency, or use the CLI to copy this component's source directly into your project — no dependency to manage, fully editable.
npm install @pinky-ui/systemspnpm add @pinky-ui/systemsyarn add @pinky-ui/systemsnpx pinky-ui add radial-meterPrefer to run the whole repository locally instead?
git clone https://github.com/florash/Pinky-UI.git
cd Pinky-UI
npm install
npm run devProps
| Prop | Type | Default | Description |
|---|---|---|---|
| segments | number | 1 | Optional meaningful intervals around the track. |
| className | string | — | Styles the outer interaction surface. |
Accessibility
- Keyboard and touch paths match the pointer interaction.
- Stable labels and values remain available without motion.
Performance
- Two SVG circles and one animated stroke offset.
Reduced motion
Motion resolves immediately while semantics, focus and state remain unchanged.
When to use
- One bounded completion or capacity value
When not to use
- Many adjacent gauges or ambiguous scores
Skill
Purpose
RadialMeter presents one bounded value in a soft editorial circle. Use it for completion, capacity or a single score where a compact shape helps scanning.
Avoid speedometer aesthetics, ambiguous scores, many adjacent meters or replacing exact text with arc length. Segments should represent meaningful intervals, not decoration.
The wrapper exposes semantic meter min/max/current values and visible text. Reduced motion updates immediately. Keep color secondary to the numeric value and label, and use Comparison Bars when users need relative comparison.