Charts - Sparkline

Sparkline charts can provide an overview of data trends.

Basics

A sparkline is a small chart drawn without axes or coordinates, that presents the general shape of a variation in a simplified way. The <SparkLineChart /> requires only the data props which is an array of numbers. You can also switch from line to a bar plot with plotType="bar".

<Box sx={{ flexGrow: 1 }}>
  <SparkLineChart data={[1, 4, 2, 5, 7, 2, 4, 6]} height={100} />
</Box>
<Box sx={{ flexGrow: 1 }}>
  <SparkLineChart
    plotType="bar"
    data={[1, 4, 2, 5, 7, 2, 4, 6]}
    height={100}
  />
</Box>

<Box sx={{ flexGrow: 1 }}>
  <SparkLineChart data={[1, 4, 2, 5, 7, 2, 4, 6]} height={100} />
</Box>
<Box sx={{ flexGrow: 1 }}>
  <SparkLineChart
    plotType="bar"
    data={[1, 4, 2, 5, 7, 2, 4, 6]}
    height={100}
  />
</Box>

Press Enter to start editing

Line customization

You can fill the area below the sparkline curve with the area prop. To modify the curve interpolation, use the curve prop. Read the full documentation for curves in the line charts page.

<Box sx={{ flexGrow: 1 }}>
  <SparkLineChart data={[3, -10, -2, 5, 7, -2, 4, 6]} height={100} area />
</Box>
<Box sx={{ flexGrow: 1 }}>
  <SparkLineChart
    data={[3, -10, -2, 5, 7, -2, 4, 6]}
    height={100}
    curve="natural"
    area
  />
</Box>

<Box sx={{ flexGrow: 1 }}>
  <SparkLineChart data={[3, -10, -2, 5, 7, -2, 4, 6]} height={100} area />
</Box>
<Box sx={{ flexGrow: 1 }}>
  <SparkLineChart
    data={[3, -10, -2, 5, 7, -2, 4, 6]}
    height={100}
    curve="natural"
    area
  />
</Box>

Press Enter to start editing

Interaction

Compared to line and bar charts, the sparkline has some additional props to simplify interaction configuration. You can use showTooltip and showHighlight to display the default tooltip and highlight in your sparkline.

Those are helpers. If you need more advanced customization, you can provide custom props for tooltip and highlight as described in the Tooltip page.

showHighlightshowTooltip

Axis management

X-axis data

By default, the sparkline assigns xAxis values as an ascending integer sequence starting from 0 (0, 1, 2,...). These values are, in this case, hidden in the tooltip. You can override this behavior if your data are not evenly distributed, or if you need to label them.

To do so, use the xAxis prop. Notice that sparkline does not manage multiple axes, so xAxis prop takes an axis configuration object. Whereas most of the other charts expect an array of axis configuration objects.

<SparkLineChart data={[1, 4, 2, 5, 7, 2, 4, 6]} xAxis={{ scaleType, data }} />

Y-axis range

You can fix the y-range of the sparkline by providing min/max values to the yAxis configuration.

The following demo shows two sparklines, one with small and another with large values. The first row has the default y-axis values, while on the second row a fixed range from 0 to 100 has been set.

Without fixed y-range

With y-range fixed to [0, 100]

You can adjust the y-axis range of a sparkline relatively to its data by using the domainLimit option in the yAxis configuration. See the axis docs page for more information.

The demo below shows different ways to set the y-axis range. They always display the same data, going from -15 to 92, but with different domainLimit settings.

domain limit

y-axis range: -100, 100

API

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

<SparkLineChart />