@baneung-pack

한글 숫자 포맷

한글 숫자 포맷 (valueFormat="korean") — 큰 수치를 자동으로 만/억/조 단위로 표시. tooltip · 막대 위 라벨 · y축 tick 모두 일관 적용. 접근성 sr-only 테이블도 자동 포함.

분기별 매출 및 영업이익 (원)
quarter매출영업이익
23 Q11.3억1800만
23 Q21.5억2200만
23 Q31.6억2800만
23 Q41.9억3500만
24 Q12.1억4200만
24 Q22.5억5100만

API

BarChartProps

PropertyType기본값설명
xKeystring필수X축 키
yKeysstring[]필수Y축 키들 (시리즈)
labelsRecord<string, string>-시리즈 표시명 (범례·툴팁)
horizontalbooleanfalse가로 막대 모드
stackedbooleanfalse누적 표시
showValuesbooleanfalse각 막대 중앙에 값 표시

ChartBaseProps

PropertyType기본값설명
dataRecord<string, unknown>[]필수차트 데이터 배열
heightnumber300차트 높이(px). 너비는 부모 100%
colorsreadonly string[]DEFAULT_COLORS시리즈 컬러 팔레트 (navy/teal 기반 10색)
showGridbooleantrue그리드 표시 (Pie/Doughnut에는 무시)
showLegendbooleantrue범례 표시
showTooltipbooleantrue툴팁 표시
emptyStateReactNode-빈 데이터일 때 표시
classNamestring-외부 wrapper className
valueFormat'plain' | 'comma' | 'korean' | (n: number) => string'plain'숫자 포맷 (tooltip / 라벨 / y축 tick 일관 적용). `korean` → 125만/1.2억, `comma` → 1,250,000, 함수로 단위 suffix 가능
a11yTablebooleantrue접근성용 sr-only 데이터 테이블 자동 렌더 (스크린리더가 canvas 차트 데이터를 읽을 수 있게 함)
a11yCaptionstring-sr-only 테이블 caption (스크린리더가 먼저 읽음)