involve-it / rd3

react + d3

rd3 (forked from react-d3)

Modular ReactJS charts made using d3 chart utilities.

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

Note: rd3 depends on react and d3, you will need to include those scripts if you aren't yet.

• https://npmcdn.com/react/dist/react.min.js
• https://npmcdn.com/react-dom/dist/react-dom.min.js
• https://npmcdn.com/d3

You can refer to fiddle example too.

NPM

Or via npm:

If you havn't installed react and d3 then:

npm install react react-dom
// currently we do not support d3@v4.0
npm install d3@v3.5.17

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 documentation:

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.

Support

• Chat:
• Issues: rd3 issues on Github

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-2016 Eric. S Bullington, Lim Yang Wei, and project contributors