Go to file
Victor Choueiri b9496c6ada
Merge pull request #7 from rkc13/patch-1
Update README.md errors
2018-02-01 17:38:28 +02:00
example Add randomly generated radials example 2017-11-03 13:45:27 +02:00
lib Document data entry classes 2017-11-05 20:28:28 +02:00
screenshots Add randomly generated radials example 2017-11-03 13:45:27 +02:00
test Initial commit 2017-11-03 01:54:40 +02:00
.gitignore Initial commit 2017-11-03 01:54:40 +02:00
CHANGELOG.md Initial commit 2017-11-03 01:54:40 +02:00
flutter_circular_chart.iml Initial commit 2017-11-03 01:54:40 +02:00
LICENSE Update LICENSE 2017-11-03 03:50:20 +02:00
pubspec.yaml Add author and homepage to pubspec 2017-11-03 04:11:54 +02:00
README.md Update README.md errors 2018-01-26 22:46:05 -08:00

Flutter Circular Chart

A library for creating animated circular chart widgets with Flutter, inspired by Zero to One with Flutter.

Overview

Create easily animated pie charts and radial charts by providing them with data objects they can plot into charts and animate between.

animated pie chart animated radial chart animated_random_radial_chart

Check the examples folder for the source code for the above screenshots.

Contents:

Installation

Note: This is a WIP early implementation, use at your own risk. You can install it by including this git repository in your package dependencies:

  dependencies:
      flutter_circular_chart:
        git:
          url: git://github.com/xqwzts/flutter_circular_chart.git

Getting Started

Import the package:

import 'package:flutter_circular_chart/flutter_circular_chart.dart';

Create chart data entry objects:

final GlobalKey<AnimatedCircularChartState> _chartKey;

List<CircularStackEntry> data = <CircularStackEntry>[
  new CircularStackEntry(
    <CircularSegmentEntry>[
      new CircularSegmentEntry(500.0, Colors.red[200], rankKey: 'Q1'),
      new CircularSegmentEntry(1000.0, Colors.green[200], rankKey: 'Q2'),
      new CircularSegmentEntry(2000.0, Colors.blue[200], rankKey: 'Q3'),
      new CircularSegmentEntry(1000.0, Colors.yellow[200], rankKey: 'Q4'),
    ],
    rankKey: 'Quarterly Profits',
  ),
];

Create an AnimatedCircularChart:

@override
Widget build(BuildContext context) {
  return new AnimatedCircularChart(
    key: _chartKey,
    size: const Size(300.0, 300.0),
    initialChartData: data,
    chartType: CircularChartType.Pie,
  );
}

Call updateData to animate the chart:

void _cycleSamples() {
  List<CircularStackEntry> nextData = <CircularStackEntry>[
    new CircularStackEntry(
      <CircularSegmentEntry>[
        new CircularSegmentEntry(1500.0, Colors.red[200], rankKey: 'Q1'),
        new CircularSegmentEntry(750.0, Colors.green[200], rankKey: 'Q2'),
        new CircularSegmentEntry(2000.0, Colors.blue[200], rankKey: 'Q3'),
        new CircularSegmentEntry(1000.0, Colors.yellow[200], rankKey: 'Q4'),
      ],
      rankKey: 'Quarterly Profits',
    ),
  ];
  setState(() {
    _chartKey.currentState.updateData(nextData);
  });
}

Details

Chart data entries:

Charts expect a list of CircularStackEntry objects containing the data they need to be drawn.

Each CircularStackEntry corresponds to a complete circle in the chart. For radial charts that is one of the rings, for pie charts it is the whole pie.

Radial charts with multiple CircularStackEntrys will display them as concentric circles.

Each CircularStackEntry is composed of multiple CircularSegmentEntrys containing the value of a data point. In radial charts a segment corresponds to an arc segment of the current ring, for pie charts it is an individual slice.