react-native-d3-charts

react-native-d3-charts is a cross platform chart library built with d3js and react-native-svg. Currently there is a line-chart, circular progress chart, and pie-chart.

Installation

To install the library to your react-native project run the following commands:

npm install react-native-d3-charts --save
react-native link react-native-svg

Usage & Options

Pie Chart

Options:

Prop	Type	Default	Definition
size	object	{width: ,height: 320}	width and height of the chart
data	array	[]	the data object explained below
showLegend	bool	true	a flag to show/hide the legend of the chart
title	string	''	the title of the chart

The structure of the data object:

Prop	Type	Default	Definition
value	number	-	the value of the data object
startColor	string	-	the start color of the gradient for the related data
endColor	string	-	the end color of the gradient for the related data
label	string	-	the definition/label of the data
labelStyle	object	{}	style object for the label

Example:

import React, {Component} from 'react';
import {StyleSheet, ScrollView} from 'react-native';
import PieChart from "react-native-d3-charts";


type Props = {};
export default class App extends Component<Props> {
  
  state={
    chartData: [
          {
            value: 61.41,
            startColor: "#7CB5EC",
            endColor: "#7CB5EC",
            label: "Chrome",
            labelStyle: {},
          },
          {
            value: 11.84,
            startColor: "#434348",
            endColor: "#434348",
            label: "Internet Explorer",
            labelStyle: {},
          },
          {
            value: 10.85,
            startColor: "#90ED7D",
            endColor: "#90ED7D",
            label: "Firefox",
            labelStyle: {},
          },
          {
            value: 4.67,
            startColor: "#F7A25D",
            endColor: "#F7A25D",
            label: "Edge",
            labelStyle: {},
          },
          {
            value: 4.18,
            startColor: "#8085E9",
            endColor: "#8085E9",
            label: "Safari",
            labelStyle: {},
          },
          {
            value: 7.05,
            startColor: "#F15C80",
            endColor: "#F15C80",
            label: "Other",
            labelStyle: {},
          }
    ]
  }
  
  render() {
    return (
      <ScrollView contentContainerStyle={styles.container}>
        <PieChart 
          size={{height: 300, width: 300}} 
          data={this.state.chartData} 
          title="Browser market shares in January, 2018" />
      </ScrollView>
    );
  }
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    alignItems: 'center',
    backgroundColor: '#F5FCFF',
    paddingTop: 50
  },
  welcome: {
    fontSize: 20,
    textAlign: 'center',
    margin: 10,
  },
  instructions: {
    textAlign: 'center',
    color: '#333333',
    marginBottom: 5,
  },
});

Circular Progress Bar

Options:

Prop	Type	Default	Definition
size	object	{width: ,height: 320}	width and height of the chart
title	string	''	the title of the chart
value	number	47	the value of the progress
valueRange	object	{ max: 100, min: 0}	defines the range for the value
showDashedArc	bool	true	a flag to show/hide the dashed arc with value

For running the example application

To run the example application (from a cloned repo):

cd example
npm i
react-native link react-native-svg
react-native run-ios
# or
react-native run-android

Todo

The next steps:

• Add animations to the charts
• More axis controls (to control scale)
• Events
• Improve the documentation
• Bug fixing, unit testing, cleanup