amCharts Animate

Version: 1.2.0

Description

Smoothly animates the dataProvider

It works with serial, pie, XY, funnel, and radar.

Here are some examples:

Serial chart (line)

Serial chart (column)

Pie chart

XY chart

Funnel chart

Radar chart

Installation

Include animate.min.js on your web page:

<script src="//www.amcharts.com/lib/3/plugins/animate/animate.min.js"></script>

Usage

Rather than using chart.validateData, instead use chart.animateData:

chart.animateData(newData, { duration: 1000 });

It will now smoothly animate from the old data to the new data.

The first argument is the new dataProvider for the chart.

The second argument is an object that can contain the following options:

• duration is required: it is the number of milliseconds that the animation should play for.

• complete is optional: it is a function that is called when the animation completes.

• fixedMinMax is optional: if set to true it will cause the minimum and maximum to not change while animating.

The new dataProvider must be different from the old dataProvider

If you want to modify the existing dataProvider, you must create a deep copy:

// Creates a deep copy of the old dataProvider
var newDataProvider = JSON.parse(JSON.stringify(chart.dataProvider));

// Adds new data to the new dataProvider
newDataProvider.push({ category: "foo", value: 10 });

// Mutates the data in the new dataProvider
newDataProvider[0].value = 50;

// Animates with the new dataProvider
chart.animateData(newDataProvider, { duration: 1000 });

License

All software included in this collection is licensed under Apache License 2.0.

This basically means you're free to use or modify it, even make your own versions or completely different products out of them.

Please see attached file "license.txt" for the complete license or online here:

http://www.apache.org/licenses/LICENSE-2.0

Contact us

• Email: contact@amcharts.com
• Web: http://www.amcharts.com/
• Facebook: https://www.facebook.com/amcharts
• Twitter: https://twitter.com/amcharts

Changelog

1.2.0

• Adding in new fixedMinMax option

1.1.2

• Fixing a bug with the minimum/maximum

1.1.1

• It now automatically sets the minimum/maximum on the value axes while animating

1.1.0

• Adding in support for XY charts

1.0.0

• Initial release