Skip to content
+

Charts - Radar 🚧

Radar allows to compare multivariate data in a 2D chart.

Basics

A radar chart is defined by two main props:

  • The series prop which provides the values to display thanks to the data property.
  • The radar prop which defines the radar axes.
  • Lisa
MathChineseEnglishGeographyPhysicsHistory
Press Enter to start editing

Multi-series

You can plot multiple series on the same radar chart.

  • USA
  • Australia
  • United Kingdom
OilCoalGasFlaringOtherindustryCement

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
MathChineseEnglishGeographyPhysicsHistory
Press Enter to start editing

Grid

The radar chart displays a grid behind the series that can be configured with:

  • startAngle The rotation angle of the entire chart in degrees.
  • divisions The number of divisions of the grid.
  • shape The grid shape that can be circular or sharp.
MathChineseEnglishGeographyPhysicsHistory
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
MathChineseEnglishGeographyPhysicsHistory
  • Lisa
  • Bart
MathChineseEnglishGeographyPhysicsHistory

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
OilCoalGasFlaringOtherindustryCement

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
OilCoalGasFlaringOtherindustryCement

API

See the documentation below for a complete reference to all of the props and classes available to the components mentioned here.