ScatterPlot API

API reference docs for the React ScatterPlot component. Learn about the props, CSS, and other APIs of this exported module.

Demos

For examples and details on the usage of this React component, visit the component demo pages:

Import

import { ScatterPlot } from '@mui/x-charts/ScatterChart';
// or
import { ScatterPlot } from '@mui/x-charts';
// or
import { ScatterPlot } from '@mui/x-charts-pro';
// or
import { ScatterPlot } from '@mui/x-charts-premium';

Learn about the difference by reading this guide on minimizing bundle size.

Props

Name	Type	Default	Description
classes	object	-	Override or extend the styles applied to the component. See CSS classes API below for more details.
onItemClick	func	-	Callback fired when a marker is clicked directly. For closest-point clicks (the `ScatterChart` default), pass `onItemClick` to the chart container instead. Signature:`function(event: MouseEvent, scatterItemIdentifier: ScatterItemIdentifier) => void` `event` Mouse event recorded on the `<svg/>` element. `scatterItemIdentifier` The scatter item identifier.
renderer	'svg-batch' \| 'svg-progressive' \| 'svg-single'	'svg-single'	The type of renderer to use for the scatter plot. - `svg-single`: Renders every scatter item in a `<circle />` element, synchronously. - `svg-progressive`: Renders every scatter item in a `<circle />` element, in progressive batches that paint over several animation frames to keep the main thread responsive. - `svg-batch`: Batch renders scatter items in `<path />` elements for better performance with large datasets, at the cost of some limitations. Read more: https://mui.com/x/react-charts/scatter/#performance When not set, defaults to `svg-single`. Enable the `progressiveRendering` experimental feature to auto-select `svg-progressive` above an internal point-count threshold; this will become the default in the next major version.
slotProps	object	{}	The props used for each component slot.
slots	object	{}	Overridable component slots. See Slots API below for more details.

The component cannot hold a ref.

Slots

Slot name	Class name	Default component	Description
marker	.MuiScatterChart-marker	`ScatterMarker`	The component that renders the marker for a scatter point.
scatter			The component that renders the scatter markers.

CSS classes

These class names are useful for styling with CSS. They are applied to the component's slots when specific states are triggered.

Class name	Rule name	Description
.MuiScatterChart-focusedMark	focusedMark	Styles applied to the focused scatter mark element.
.MuiScatterChart-highlightedMark	highlightedMark	Styles applied to the highlighted scatter mark element.
.MuiScatterChart-root	root	Styles applied to the scatter plot element.
.MuiScatterChart-series	series	Styles applied to the group surrounding a series' scatter elements.

You can override the style of the component using one of these customization options:

With a global class name.
With a rule name as part of the component's styleOverrides property in a custom theme.

Source code

If you did not find the information in this page, consider having a look at the implementation of the component for more detail.