reopt design
DocsExploreTemplatesCanvasToolsPricing
Login
opt-uiopt-chartsopt-datagridopt-editoropt-calendaropt-filemanageropt-chatopt-shellbrandapp-ui
opt-charts40
GaugeChart
reopt designreopt design

A design system for the AI era

  • Docs
  • Pricing
  • Releases
  • About
  • Contact
  • Terms of Service
  • Privacy Policy

reopt Inc.Business registration no. 217-88-02453contact@reopt.ai

© 2026 reopt Inc. All rights reserved.

GaugeChart

Chart

Show one KPI or progress value on a 270-degree SVG dial with minimum and maximum ticks.

radial
Related docs
bun add @reopt-ai/opt-charts
Install and import
bash
bun add @reopt-ai/opt-charts
tsx
import { GaugeChart } from "@reopt-ai/opt-charts";

Live preview

Change the width and theme, then interact with the components.

100%

Percent gauges

Gauge: 72 of 10072Performance0100
Gauge: 45 of 10045Conversion0100
Gauge: 92% of 10092%Uptime0100

Non-percent domain

min={-20} max={40} with valueLabel

Outdoor temperature gauge, 12 degrees Celsius12°COutdoor temp-2040

GaugeChart

PropTypeDefaultDescription
valueRequirednumber—현재 값
minnumber0최소값
maxnumber100최대값
labelstring—값 아래 캡션
valueLabelstring—중앙 값 텍스트를 대체하는 문자열
sizenumber200차트 크기 (px)
strokeWidthnumber20호 두께
colorstring"var(--opt-chart-1)"값 arc 색
trackColorstring"var(--opt-border-subtle)"트랙 색상
showScalebooleantrue호 양끝 아래에 min/max 레이블 표시
valueFormatter(value: number) => string—값을 표시 문자열로 바꾸는 함수. 기본은 locale 인식 숫자 포맷
localestring—기본 숫자 포맷에 쓰는 locale. 생략하면 런타임 locale
labelsGaugeChartLabels—지역화 문자열. chartName은 기본 접근성 이름 템플릿({value}·{max}·{min} 치환)
classNamestring—루트 요소에 붙는 CSS 클래스
aria-labelstring—스크린 리더용 레이블. 기본 "Gauge: 42 of 100"
aria-describedbystring—차트를 설명하는 요소의 id

컴포넌트 의존 관계

깊이
▲ USED BY (1)user-detailGaugeChart
View test results

테스트 커버리지

2026년 7월 9일

생성된 테스트 결과를 찾지 못했습니다.

GaugeChart 항목이 문서 메타에 연결되어 있지만 현재 생성 파일에는 없습니다.

테스트를 추가한 뒤 `bun run generate:test-results`를 실행하거나 `testDescribe` 매핑을 다시 확인하세요.

Blocks that use this component

opt-ui

UserDetail

Blocks

Build user profiles with avatars, metrics, gauges, progress indicators, tables, and filters.

Related components

opt-charts

PieChart

Charts

Visualize proportions with a pie or donut chart using innerRadius. Consider a single metric for a two-part split.

opt-charts

RadarChart

Charts

Compare balance across multiple dimensions with polygon radar charts.

opt-charts

RadialBarChart

Charts

Compare progress or proportions across items with concentric rings.

opt-charts

Sunburst

Charts

Represent hierarchical proportions as concentric arcs with accessible names, values, percentages, and top-level legends.

opt-charts

ChartContainer

Charts

Wrap Recharts ResponsiveContainer with accessible attributes and consistent chart styling.

opt-charts

ChartTooltip

Charts

Style Recharts tooltips with tooltip semantics and hidden decorative markers through the content prop.

PreviousComparisonChartNextFunnelChart