@baneung-pack

막대 차트

카테고리별 비교에 적합한 막대 차트. xKey + yKeys로 시리즈를 지정합니다. stacked / horizontal 옵션 지원.

month매출이익
1월1200300
2월1500400
3월1300350
4월1700500
5월1900580
6월2100620

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 (스크린리더가 먼저 읽음)