react-chartjs-2

What is react-chartjs-2?

The react-chartjs-2 npm package is a React wrapper for Chart.js, a popular JavaScript library for creating simple yet flexible charts. It allows developers to create various types of charts such as line, bar, radar, doughnut, and pie charts, among others, with ease. The package provides React components that encapsulate Chart.js functionality, making it easy to integrate into React applications.

What are react-chartjs-2's main functionalities?

Line Chart

This code sample demonstrates how to create a simple line chart using react-chartjs-2. It includes a dataset for monthly sales and configures the chart to start the y-axis at zero.

{"import { Line } from 'react-chartjs-2';\n\nconst data = {\n  labels: ['January', 'February', 'March', 'April', 'May', 'June'],\n  datasets: [{\n    label: 'Monthly Sales',\n    data: [65, 59, 80, 81, 56, 55],\n    fill: false,\n    borderColor: 'rgb(75, 192, 192)',\n    tension: 0.1\n  }]\n};\n\nconst options = {\n  scales: {\n    y: {\n      beginAtZero: true\n    }\n  }\n};\n\nfunction MyLineChart() {\n  return <Line data={data} options={options} />;\n}"}

Bar Chart

This code sample shows how to create a bar chart with react-chartjs-2. It sets up a dataset with different colors for each bar representing votes for different options.

{"import { Bar } from 'react-chartjs-2';\n\nconst data = {\n  labels: ['Red', 'Blue', 'Yellow', 'Green', 'Purple', 'Orange'],\n  datasets: [{\n    label: 'Votes',\n    data: [12, 19, 3, 5, 2, 3],\n    backgroundColor: [\n      'rgba(255, 99, 132, 0.2)',\n      'rgba(54, 162, 235, 0.2)',\n      'rgba(255, 206, 86, 0.2)',\n      'rgba(75, 192, 192, 0.2)',\n      'rgba(153, 102, 255, 0.2)',\n      'rgba(255, 159, 64, 0.2)'\n    ],\n    borderColor: [\n      'rgba(255, 99, 132, 1)',\n      'rgba(54, 162, 235, 1)',\n      'rgba(255, 206, 86, 1)',\n      'rgba(75, 192, 192, 1)',\n      'rgba(153, 102, 255, 1)',\n      'rgba(255, 159, 64, 1)'\n    ],\n    borderWidth: 1\n  }]\n};\n\nfunction MyBarChart() {\n  return <Bar data={data} />;\n}"}

Doughnut Chart

This code sample illustrates how to create a doughnut chart using react-chartjs-2. It includes a dataset with three segments, each with its own color.

{"import { Doughnut } from 'react-chartjs-2';\n\nconst data = {\n  labels: ['Red', 'Blue', 'Yellow'],\n  datasets: [{\n    data: [300, 50, 100],\n    backgroundColor: [\n      '#FF6384',\n      '#36A2EB',\n      '#FFCE56'\n    ],\n    hoverBackgroundColor: [\n      '#FF6384',\n      '#36A2EB',\n      '#FFCE56'\n    ]\n  }]\n};\n\nfunction MyDoughnutChart() {\n  return <Doughnut data={data} />;\n}"}

Other packages similar to react-chartjs-2

recharts

Recharts is a composable charting library built on React components. It uses D3.js under the hood for sophisticated charting capabilities. Compared to react-chartjs-2, Recharts offers a more React-friendly API with the ability to compose charts using declarative components.

victory

Victory is another React chart library that provides an extensive collection of composable components for building interactive data visualizations. Victory charts are highly customizable and can be styled using standard inline styles, which might appeal to developers looking for a more integrated React experience compared to react-chartjs-2.

nivo

Nivo provides a rich set of dataviz components built on top of D3.js, with a strong emphasis on motion and interactivity. It offers a higher level of abstraction compared to react-chartjs-2 and includes a wide range of chart types with beautiful default styles and animations.

README

Looking for maintainers!!

react-chartjs-2

React wrapper for Chart.js 2 Open for PRs and contributions!

UPDATE to 2.x

As of 2.x we have made chart.js a peer dependency for greater flexibility. Please add chart.js as a dependency on your project to use 2.x. Currently, 2.5.x is the recommended version of chart.js to use.

Demo & Examples

Live demo: jerairrest.github.io/react-chartjs-2

To build the examples locally, run:

npm install
npm start

Then open localhost:8000 in a browser.

Demo & Examples via React Storybook

We have to build the package, then you can run storybook.

npm run build
npm run storybook

Then open localhost:6006 in a browser.

Installation via NPM

npm install --save react-chartjs-2 chart.js

Usage

Check example/src/components/* for usage.

import { Doughnut } from 'react-chartjs-2';

<Doughnut data={...} />

Properties

• data: (PropTypes.object | PropTypes.func).isRequired,
• width: PropTypes.number,
• height: PropTypes.number,
• id: PropTypes.string,
• legend: PropTypes.object,
• options: PropTypes.object,
• redraw: PropTypes.bool,
• getDatasetAtEvent: PropTypes.func,
• getElementAtEvent: PropTypes.func,
• getElementsAtEvent: PropTypes.func
• onElementsClick: PropTypes.func, // alias for getElementsAtEvent (backward compatibility)

Custom size

In order for Chart.js to obey the custom size you need to set maintainAspectRatio to false, example:

<Bar
  data={data}
  width={100}
  height={50}
  options={{ maintainAspectRatio: false }}
/>

Chart.js instance

Chart.js instance can be accessed by placing a ref to the element as:

chartReference = {};

componentDidMount() {
  console.log(this.chartReference); // returns a Chart.js instance reference
}

render() {
  return (<Doughnut ref={(reference) => this.chartReference = reference } data={data} />)
}

Getting context for data generation

Canvas node and hence context, that can be used to create CanvasGradient background, is passed as argument to data if given as function:

This approach is useful when you want to keep your components pure.

render() {
  const data = (canvas) => {
    const ctx = canvas.getContext("2d")
    const gradient = ctx.createLinearGradient(0,0,100,0);
    ...
    return {
      ...
      backgroundColor: gradient
      ...
    }
  }

  return (<Line data={data} />)
}

Chart.js Defaults

Chart.js defaults can be set by importing the defaults object:

import { defaults } from 'react-chartjs-2';

// Disable animating charts by default.
defaults.global.animation = false;

If you want to bulk set properties, try using the lodash.merge function. This function will do a deep recursive merge preserving previously set values that you don't want to update.

import { defaults } from 'react-chartjs-2';
import merge from 'lodash.merge';
// or
// import { merge } from 'lodash';

merge(defaults, {
  global: {
    animation: false,
    line: {
      borderColor: '#F85F73',
     },
  },
});

Chart.js object

You can access the internal Chart.js object to register plugins or extend charts like this:

import { Chart } from 'react-chartjs-2';

componentWillMount() {
  Chart.pluginService.register({
    afterDraw: function (chart, easing) {
      // Plugin code.
    }
  });
}

Scatter Charts

If you're using Chart.js 2.6 and below, add the showLines: false property to your chart options. This was later added in the default config, so users of later versions would not need to do this extra step.

Events

onElementsClick || getElementsAtEvent (function)

A function to be called when mouse clicked on chart elememts, will return all element at that point as an array. Check

{
  onElementsClick: (elems) => {},
  getElementsAtEvent: (elems) => {},
  // `elems` is an array of chartElements
}

getElementAtEvent (function)

Calling getElementAtEvent(event) on your Chart instance passing an argument of an event, or jQuery event, will return the single element at the event position. If there are multiple items within range, only the first is returned Check

{
  getElementAtEvent: (elems) => {},
  // => returns the first element at the event point.
}

getDatasetAtEvent (function)

Looks for the element under the event point, then returns all elements from that dataset. This is used internally for 'dataset' mode highlighting Check

{
  getDatasetAtEvent: (dataset) => {}
  // `dataset` is an array of chartElements
}

Working with Multiple Datasets

You will find that any event which causes the chart to re-render, such as hover tooltips, etc., will cause the first dataset to be copied over to other datasets, causing your lines and bars to merge together. This is because to track changes in the dataset series, the library needs a key to be specified - if none is found, it can't tell the difference between the datasets while updating. To get around this issue, you can take these two approaches:

1. Add a label property on each dataset. By default, this library uses the label property as the key to distinguish datasets.
2. Specify a different property to be used as a key by passing a datasetKeyProvider prop to your chart component, which would return a unique string value for each dataset.

Development (src, lib and the build process)

NOTE: The source code for the component is in src. A transpiled CommonJS version (generated with Babel) is available in lib for use with node.js, browserify and webpack. A UMD bundle is also built to dist, which can be included without the need for any build system.

To build, watch and serve the examples (which will also watch the component source), run npm start. If you just want to watch changes to src and rebuild lib, run npm run watch (this is useful if you are working with npm link).

License

MIT Licensed Copyright (c) 2017 Jeremy Ayerst