rd3 (forked from react-d3)

Modular ReactJS charts made using d3 chart utilities. Work on project documentation has started here. A few examples of the available charts can be seen below, the others can be viewed here, side-by-side with the React code that generates the charts.

Usage

The latest version of rd3 requires React 0.14 or later. If you are using older React version, please refer to here

npmcdn

Thanks to npmcdn you can now try out rd3 quickly:

• https://npmcdn.com/rd3/build/public/js/react-d3.js
• https://npmcdn.com/rd3/build/public/js/react-d3.min.js

NPM

Or via npm:

npm install rd3

Then, import into your ReactJS project:

var rd3 = require('rd3');
// es6
import rd3 from 'rd3';

The charts are then available under the rd3 namespace, which you can then use as shown on the demonstration page:

Available Charts

const BarChart = rd3.BarChart;
const LineChart = rd3.LineChart;
const PieChart = rd3.PieChart;
const AreaChart = rd3.AreaChart;
const Treemap = rd3.Treemap;
const ScatterChart = rd3.ScatterChart;
const CandleStickChart = rd3.CandleStickChart;

For usage, please see here. API documentation is also coming online over the coming days.

Support

• Chat:
• Issues: react-d3 issues on Github
• Support: react-d3 Google Groups email list

Background

Although there have been several different approaches proposed for combining the power of d3 with the flexibility and modularity of ReactJS, the approach I'm using here was inspired by this blog post by Ben Smith of Binary Consulting.

With this approach, React itself is responsible for generating the SVG markup. d3.js is used for its tremendous collection of utility functions, such as those that calculate the path value for various chart types.

License

MIT

Copyright (c) 2014-2015 Eric. S Bullington, Lim Yang Wei, and project contributors