BubbleChart
visualVisualize three dimensions through x and y positions and bubble size using the ScatterChart renderer.
100%
Bubble Chart
Single Series
테스트 커버리지
2026년 7월 9일생성된 테스트 결과를 찾지 못했습니다.
BubbleChart 항목이 문서 메타에 연결되어 있지만 현재 생성 파일에는 없습니다.
테스트를 추가한 뒤 `bun run generate:test-results`를 실행하거나 `testDescribe` 매핑을 다시 확인하세요.
BubbleChart Props
| Prop | 타입 | 기본값 | 설명 |
|---|---|---|---|
series* | BubbleSeriesDef[] | — | 시리즈 배열 ({ name, data, color? }) |
xKey | string | "x" | X축 데이터 키 |
yKey | string | "y" | Y축 데이터 키 |
sizeKey | string | "size" | 버블 넓이로 매핑할 데이터 키 |
maxBubbleSize | number | 400 | 가장 큰 버블의 넓이 (px²) |
minBubbleSize | number | SCATTER_DOT_AREA | 가장 작은 버블의 넓이 (px²). 기본은 8px 점 |
sizeName | string | — | 툴팁과 접근성 표에서 크기 값을 부르는 이름. 기본은 sizeKey |
xName | string | — | 툴팁과 접근성 표에서 X 값을 부르는 이름. 기본은 xKey |
yName | string | — | 툴팁과 접근성 표에서 Y 값을 부르는 이름. 기본은 yKey |
height | number | `${number}%` | 300 | 차트 높이 |
className | string | — | 루트 요소에 붙는 CSS 클래스 |
showGrid | boolean | true | 그리드 표시 여부. 실선 헤어라인 |
showTooltip | boolean | true | 툴팁 표시 여부 |
showLegend | boolean | — | 범례 표시 여부. 생략하면 시리즈가 둘 이상일 때만 보인다 |
showXAxis | boolean | true | X축 표시 여부 |
showYAxis | boolean | true | Y축 표시 여부 |
animate | boolean | true | false면 애니메이션을 끈다. 그 외에는 prefers-reduced-motion을 따른다 |
margin | ChartMargin | CHART_MARGIN | 차트 여백 (top/right/bottom/left) |
xFormatter | (value: number) => string | — | X축 눈금 포맷터. 기본은 로케일 compact 숫자 |
yFormatter | (value: number) => string | — | Y축 눈금 포맷터. 기본은 로케일 compact 숫자 |
locale | string | — | 기본 숫자 포맷의 로케일. 생략하면 런타임 로케일 |
loading | boolean | false | 새 데이터를 기다리는 동안 현재 렌더를 흐리게 유지 |
accessibleTable | boolean | false | 스크린 리더용 숨김 데이터 표를 함께 렌더 |
emptyState | ReactNode | — | 데이터가 없을 때 보일 내용. 생략하면 labels.empty |
labels | BubbleChartLabels | — | 사용자 노출 문자열 (empty, summaryCaption, seriesColumn, chartName). 기본은 영어 |
tooltipOptions | ChartTooltipContentProps | — | ChartTooltipContent에 그대로 넘길 옵션 |
legendOptions | ChartLegendOptions | — | ChartLegendContent에 그대로 넘길 옵션. Recharts가 산점 시리즈에 dataKey를 주지 않으므로 inactiveKeys는 dataKey가 아니라 시리즈 name으로 지정한다 |
legendToggle | boolean | true | 범례 칩 클릭으로 시리즈를 켜고 끕니다. legendOptions.inactiveKeys를 주면 호출자가 상태를 소유하고, onClick만 주면 클릭을 전달받으면서 차트가 상태를 유지합니다. 마지막 남은 시리즈는 꺼지지 않습니다. false면 정적 범례 |
aria-label | string | — | 스크린 리더용 레이블. 생략하면 차트 종류와 시리즈 이름으로 만든다 |
aria-describedby | string | — | 차트를 설명하는 요소의 id |
Import
tsx
import { BubbleChart } from "@reopt-ai/opt-ui";