rng
5.0/57
react-native-gifted-charts
npm i react-native-gifted-charts
rng

react-native-gifted-charts

The most complete library for Bar, Line, Area, Pie, Donut and Stacked Bar charts in React Native. Allows 2D, 3D, gradient, animations and live data updates.

by Abhinandan Kushwaha

1.2.41 (see all)License:MITTypeScript:Not FoundCategories:React Native Chart
npm i react-native-gifted-charts
Readme

react-native-gifted-charts Rate on Openbase

The most complete library for Bar, Line, Area, Pie, Donut and Stacked Bar charts in React Native. Allows 2D, 3D, gradient, animations and live data updates.

Yet another chart library? Why?

To bring Life to your data

  1. Plenty of features with minimal code
  2. Apply animations to your charts on load and on value change, just by adding a prop
  3. Smooth animations implemented using LayoutAnimation
  4. Clickable and scrollable
  5. Three-D and gradient effects
  6. Fully customizable (see the props)
  7. Detailed documentation with examples
  8. Support for combined Bar and Line charts


Version 1.2.x 🎉

Version 1.2.0 onwards we are dependent only on react-native-svg and react-native-linear-gradient. Earlier, Pie and Donut charts were rendered using react-native-canvas, but now they are also rendered using svg. We are no longer using react-native-canvas neither react-native-webview!

Installation

npm install react-native-gifted-charts react-native-linear-gradient react-native-svg

For iOS-

cd ios && pod install

Docs

Documentation and gallery

Usage

The simplest usage of various types of charts can be done as below-

import { BarChart, LineChart, PieChart } from "react-native-gifted-charts";

// ...
const data=[ {value:50}, {value:80}, {value:90}, {value:70} ]

<BarChart data = {data} />
<LineChart data = {data} />
<PieChart data = {data} />

// For Horizontal Bar chart, just add the prop horizontal to the <BarChart/> component

<BarChart data = {data} horizontal />

// For Area chart, just add the prop areaChart to the <LineChart/> component

<LineChart data = {data} areaChart />

// For Donut chart, just add the prop donut to the <PieChart/> component

<PieChart data = {data} donut />

Props tables

1. BarChart, Horizontal BarChart and Stacked Bar Chart props \ 2. LineChart and AreaChart props \ 3. PieChart and DonutChart props

Contributing

Dear developers! Your small contribution can make someone's day 😊

One of the ways you can contribute is to address an open issue.

Sometimes people report issues which don't exist, or request for features which are already present. Such issues can be addressed without pushing any code to the repo. Just show them in the comments how to do it.

See the contributing guide to learn how to contribute to the repository and the development workflow.

Common issues

IssueSolution
BarChart - Value and section line don't matchComment by the owner
Setting height, maxValue, stepValue, stepHeight, or noOfSections breaks the chartPlease make sure that
maxValue = noOfSections * stepValue;
is followed. See this

To-dos

To do list

License

MIT

5.0/ 5
7
Rate
5
7
4
0
3
0
2
0
1
0
Great Documentation2
Easy to Use2
Highly Customizable2
Responsive Maintainers2
Performant1

Downloads/wk

1.7K

GitHub Stars

151

LAST COMMIT

7mos ago

MAINTAINERS

1

CONTRIBUTORS

4

OPEN ISSUES

4

OPEN PRs

0
VersionTagPublished
1.2.41
latest
3mos ago

Rate & Review

100