What it does
Combines scatter points with a sized Z channel.
Decorators for grid, tooltip, and legend match other charts.
Data shape
Each row includes numeric `xKey`, numeric fields for vertical positions per series, and optional size fields referenced by `zKey`.
Common use cases
- Campaign cost versus conversions with spend as bubble size.
- Risk versus return with liquidity as radius.
- Feature adoption scatter with active users as size.
Accessibility
Size differences can be hard to judge; pair tooltips with exact values.
Avoid relying on color alone when more than a few bubbles overlap.
Next.js integration notes
Import from `@zentauri-ui/zentauri-components/charts/bubble` inside client components when interaction is required.
FAQ
What if I omit zKey?
Bubbles still render with default sizing from the ZAxis range; add `zKey` on the series when the third metric should drive radius.
Are axes always numeric?
Bubble charts use continuous axes suitable for scatter data; map categorical encodings to numbers before plotting.