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.
react-chartjs-2
React wrapper for Chart.js 2
Open for PR's and contributions!
UPDATE
Actively looking for contributors as for the moment I do not have enough time to dedicate for maintaining this lib.
All contributors can add themselves to Contributors section at the bottom of README.
Demo & Examples
Live demo: gor181.github.io/react-chartjs-2
To build the examples locally, run:
npm install
npm start
Then open localhost:8000
in a browser.
Installation via NPM
npm install react-chartjs-2 chart.js --save
Usage
Check example/src/components/* for usage.
import {Doughnut} from 'react-chartjs-2';
<Doughnut data={...} />
Properties
- data: PropTypes.object.isRequired,
- width: PropTypes.number,
- height: PropTypes.number,
- 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:
render() {
componentDidMount() {
console.log(this.refs.chart.chart_instance);
}
return (
<Doughnut ref='chart' data={data} />
)
}
Chart.js Defaults
Chart.js defaults can be set by importing the defaults
object:
import { defaults } from 'react-chartjs-2';
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';
merge(defaults, {
global: {
animation: false,
line: {
borderColor: '#F85F73',
},
},
});
Events
onElementsClick (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) => {}
}
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
).
Thanks
Jed Watson for making react-component yo builder!
License
MIT Licensed
Copyright (c) 2016 Goran Udosic
Contributors