react-native-gifted-charts/README.md

1.9 KiB

react-native-gifted-charts

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

Yet another chart library? Why?

  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
  7. Detailed documentation with examples

alt text alt text alt text

Installation

npm install react-native-gifted-charts

Since we will be using LinearGradient, Svg and Canvas-

npm i react-native-linear-gradient react-native-svg react-native-canvas react-native-webview

For iOS-

cd ios && pod install

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 and Horizontal BarChart props
2. LineChart and AreaChart props
3. PieChart and DonutChart props

Contributing

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

License

MIT