Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/RumbleInc/rumble-js-charts

React components for building composable and flexible charts
https://github.com/RumbleInc/rumble-js-charts

Last synced: 12 days ago
JSON representation

React components for building composable and flexible charts

Awesome Lists containing this project

README

        

# !!! rumble-charts was moved
https://github.com/rumble-charts/rumble-charts

# Logo rumble-charts

[![Gitter](https://img.shields.io/gitter/room/nwjs/nw.js.svg)](https://gitter.im/rumble-charts/rumble-charts)

[![Build Status](https://travis-ci.org/rumble-charts/rumble-charts.svg)](https://travis-ci.org/rumble-charts/rumble-charts)
[![codecov](https://codecov.io/gh/rumble-charts/rumble-charts/branch/master/graph/badge.svg)](https://codecov.io/gh/rumble-charts/rumble-charts)
[![Dependency Status](https://david-dm.org/rumble-charts/rumble-charts.svg)](https://david-dm.org/rumble-charts/rumble-charts)

[![npm](https://img.shields.io/npm/v/rumble-charts.svg)](https://www.npmjs.com/package/rumble-charts)
[![npm](https://img.shields.io/npm/dm/rumble-charts.svg)](https://www.npmjs.com/package/rumble-charts)

React components for building composable and flexible charts.

It's based on D3.js under the hood, but most of the time you will not feel that.

## Documentation

All examples are editable. You can see a result right on the page.

[https://rumble-charts.github.io](https://rumble-charts.github.io)

## Demo / live edit

[rosko.github.io/slides/2016-04-declarative-charts/#/liveedit](https://rosko.github.io/slides/2016-04-declarative-charts/#/liveedit)

## Installation

### NPM

```bash
npm install --save rumble-charts
```

## Usage

Just include it:

```javascript
const {
// main component
Chart,
// graphs
Bars, Cloud, Dots, Labels, Lines, Pies, RadialLines, Ticks, Title,
// wrappers
Layer, Animate, Transform, Handlers,
// helpers
helpers, DropShadow, Gradient
} = require('rumble-charts');
```

And use:

```jsx
const series = [{
data: [1, 2, 3]
}, {
data: [5, 7, 11]
}, {
data: [13, 17, 19]
}];

class Demo extends Component {
render() {
return



;
}
}
```

## Road map

- [x] Write unit tests for graphics components
- [x] Make a first version of documentation with examples
- [x] Update to React 15.x
- [x] Update to lodash 4.x
- [ ] Write unit tests for wrappers and helpers components
- [ ] Support React ART
- [ ] Support morphing between graphics types (Pies <=> Bars)

## Similar projects

Mainly there are 3 approaches to integrate React and D3:

- React wraps D3
- [d3-react-squared](https://github.com/bgrsquared/d3-react-squared)
- [d3act](https://github.com/AnSavvides/d3act)
- D3 prepares virtual DOM for React
- [react-faux-dom](https://github.com/Olical/react-faux-dom)
- [d3-react-sparkline](https://github.com/QubitProducts/d3-react-sparkline/) - based on react-faux-dom
- React builds virtual DOM, D3 makes math (`rumble-charts` is here)
- [react-d3-components](https://github.com/codesuki/react-d3-components)
- [react-d3](https://github.com/esbullington/react-d3/) and [rd3](https://github.com/yang-wei/rd3) as a fork
- [react-vis](https://github.com/uber/react-vis)
- [victory](https://github.com/FormidableLabs/victory)

## License

MIT