Charts - Radar 🚧
Radar allows to compare multivariate data in a 2D chart.
Basics
A radar chart is defined by two main props:
- The
seriesprop which provides the values to display thanks to thedataproperty. - The
radarprop which defines the radar axes.
- Lisa
Multi-series
You can plot multiple series on the same radar chart.
- USA
- Australia
- United Kingdom
Axis
The metrics property of radar takes an array with one item per corner of the radar.
This item can either be:
- A string used as the axis label. The other properties are populated from the data.
- An object with the following properties:
name: The label associated to the axis.min: The minimum value along this direction (by default 0).max: The maximum value along this direction (by default the maximum value along this direction).
- Lisa
Grid
The radar chart displays a grid behind the series that can be configured with:
startAngleThe rotation angle of the entire chart in degrees.divisionsThe number of divisions of the grid.shapeThe grid shape that can becircularorsharp.
import { Unstable_RadarChart as RadarChart } from '@mui/x-charts/RadarChart';
<RadarChart
{/** ... */}
shape="circular"
divisions={10}
radar={{
startAngle: 30,
metrics: [...],
}}
/>Playground
Interaction 🚧
Axis click 🚧
Item click 🚧
Highlight
Axis Highlight
By default the radar highlight values of a same axis.
This axis highlight has two visualizations available with the prop axisHighlightShape:
'points'Displays points on each highlighted value (best with multiple series).'slice'Displays a slice around the highlighted value. (best with a single series).
With composition you can add this behavior with the <RadarAxisHighlight axisHighlightShape='slice' /> component.
- Lisa
- Lisa
- Bart
Series Highlight
To set the highlight on series, use the highlight prop with 'series' value.
This highlight can be controlled with highlightedItem value and onHighlightChange callback.
With composition you can pass those props to the RadarDataProvider.
This demo shows a controlled highlight.
Notice the impact of the series order in the highlight interaction.
The UK series is the last item of the series prop.
Such that its area renders on top of the others.
Otherwise, the other area would catch the pointer event, making it impossible to highlight it.
- USA
- Australia
- United Kingdom
Disabling Highlight
To remove highlight, set the highlight prop to 'none'.
Tooltip 🚧
Composition 🚧
For composition, use the RadarDataProvider to provide series and radar props.
Providing components for radar composition is still a work in progress. If you miss some element or explanation, please open an issue describing what you want to achieve, and what is missing.
In this example, we uses RadarSeriesArea and RadarSeriesMarks to modify the order of the elements:
all the marks are on top of all the path.
Additionally, we apply different properties based on the series id.
- USA
- Australia
API
See the documentation below for a complete reference to all of the props and classes available to the components mentioned here.