GaugeChart
visualShow one KPI or progress value on a 270-degree SVG dial with minimum and maximum ticks.
컴포넌트 의존 관계
깊이
100%
Percent gauges
Non-percent domain
min={-20} max={40} with valueLabel
테스트 커버리지
2026년 7월 9일생성된 테스트 결과를 찾지 못했습니다.
GaugeChart 항목이 문서 메타에 연결되어 있지만 현재 생성 파일에는 없습니다.
테스트를 추가한 뒤 `bun run generate:test-results`를 실행하거나 `testDescribe` 매핑을 다시 확인하세요.
GaugeChart Props
| Prop | 타입 | 기본값 | 설명 |
|---|---|---|---|
value* | number | — | 현재 값 |
min | number | 0 | 최소값 |
max | number | 100 | 최대값 |
label | string | — | 값 아래 캡션 |
valueLabel | string | — | 중앙 값 텍스트를 대체하는 문자열 |
size | number | 200 | 차트 크기 (px) |
strokeWidth | number | 20 | 호 두께 |
color | string | "var(--opt-chart-1)" | 값 arc 색 |
trackColor | string | "var(--opt-border-subtle)" | 트랙 색상 |
showScale | boolean | true | 호 양끝 아래에 min/max 레이블 표시 |
valueFormatter | (value: number) => string | — | 값을 표시 문자열로 바꾸는 함수. 기본은 locale 인식 숫자 포맷 |
locale | string | — | 기본 숫자 포맷에 쓰는 locale. 생략하면 런타임 locale |
labels | GaugeChartLabels | — | 지역화 문자열. chartName은 기본 접근성 이름 템플릿({value}·{max}·{min} 치환) |
className | string | — | 루트 요소에 붙는 CSS 클래스 |
aria-label | string | — | 스크린 리더용 레이블. 기본 "Gauge: 42 of 100" |
aria-describedby | string | — | 차트를 설명하는 요소의 id |
Import
tsx
import { GaugeChart } from "@reopt-ai/opt-ui";