Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yang-wei/rd3
react + d3
https://github.com/yang-wei/rd3
Last synced: 13 days ago
JSON representation
react + d3
- Host: GitHub
- URL: https://github.com/yang-wei/rd3
- Owner: yang-wei
- License: mit
- Archived: true
- Created: 2016-03-30T13:48:25.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-11-04T15:59:24.000Z (about 7 years ago)
- Last Synced: 2024-09-19T04:49:04.249Z (about 2 months ago)
- Language: JavaScript
- Homepage: https://yang-wei.github.io/rd3/
- Size: 2.89 MB
- Stars: 319
- Watchers: 21
- Forks: 83
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
## Future of rd3
Currently I don't have time to manage this library anymore so if someone is willing to maintain I would like to transfer this repository. Please see https://github.com/yang-wei/rd3/issues/88
Let us discuss where will this library heading.
## [rd3](https://github.com/yang-wei/rd3) (forked from [react-d3](https://github.com/esbullington/react-d3))
Modular ReactJS charts made using d3 chart utilities.
[](https://badge.fury.io/js/rd3)
## Usage
The latest version of rd3 requires **React 0.14 or later**. If you are using older React version, please refer to [here](https://github.com/yang-wei/rd3/releases/tag/v0.5.3)
### npmcdn
Thanks to [npmcdn](https://npmcdn.com/) 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](https://yang-wei.github.io/rd3/docs/new/charts/areaChart.html) too.
### NPM
Or via `npm`:
If you havn't installed `react` and `d3` then:
```
npm install react react-dom
// currently we do not support [email protected]
npm install [email protected]
```
```
npm install rd3
```
Then, import into your ReactJS project:
```js
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](https://yang-wei.github.io/rd3/):
### Available Charts
```js
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](https://yang-wei.github.io/rd3).
### Support
* Chat: [](https://gitter.im/esbullington/react-d3?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
* Issues: [rd3 issues](https://github.com/yang-wei/rd3/issues) on Github
### Background
Although there have been [several](http://nicolashery.com/integrating-d3js-visualizations-in-a-react-app/) [different](http://bl.ocks.org/milroc/d22bbf92231876505e5d) 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](http://10consulting.com/2014/02/19/d3-plus-reactjs-for-charting/) by Ben Smith of [Binary Consulting](http://10consulting.com/).
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](https://github.com/yang-wei/rd3/graphs/contributors)