react-d3

Modular React charts made with d3.js

Github星跟踪图

Update

Important update:

The actively maintained fork of this project is now at the Github of react-d3 co-creator yang-wei, who has recently taken the lead in maintaining the project and moving toward 1.0.

Yang Wei's fork is located here.

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.

react-d3 chart images

Build Status

Version

npm version

Basic usage

First, install via npm:

npm install react-d3

Then, import into your ReactJS project:

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

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

If you don't wish to pull in all the charts, you can also require single chart:

var BarChart = require('react-d3/barchart').BarChart;
// es6
import { BarChart } from 'react-d3';

Available Charts

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

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

JSFiddle

There's a development build available for experimentation on JSFiddle: http://jsfiddle.net/esbullington/jp9dkh1g/.

Please note that this build should probably not be used in production, since it bundles all of react-d3's dependencies in a single bundle (this is also the cause of the "Cannot read property 'firstChild' of undefined" error message on the JS console, which occurs when there are two React libraries in the same namespace).

All the react-d3 charts are available in this JSFiddle fork under the global rd3 namespace.

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.

Roadmap

For current roadmap, please see Yang Wei's fork at: https://github.com/yang-wei/rd3

License

MIT

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

主要指标

概览
名称与所有者esbullington/react-d3
主编程语言JavaScript
编程语言HTML (语言数: 2)
平台
许可证MIT License
所有者活动
创建于2014-10-30 22:01:23
推送于2016-06-07 16:22:56
最后一次提交2016-04-08 20:21:51
发布数8
最新版本名称v0.4.0 (发布于 )
第一版名称v0.1.3 (发布于 2015-01-25 20:07:29)
用户参与
星数1.7k
关注者数58
派生数177
提交数761
已启用问题?
问题数156
打开的问题数14
拉请求数163
打开的拉请求数0
关闭的拉请求数28
项目设置
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?