Animate

Search…
Animate
The charts for mobile should be more vividness. So F2 provides an animation mechanism.
How to Register Animation Plugin
F2 has modular structure provides best tree-shaking results and package size optimization. 
If you just import F2 from '@antv/f2', then it has included Animation by default. But if you want a better package size optimization, you can register manually:
const F2 = require('@antv/f2/lib/core');
const Animation = require('@antv/f2/lib/animation/detail');
// Method 1: Global Registeration
F2.Chart.plugins.register(Animation); 
​
// Or Method2: Registeration for a Chart instance
const chart = new F2.Chart({
  id: 'canvas',
  plugins: Animation
});
Animation Introduction
F2 animations are all animated in shapes. According to the change of the chart's data, we classified animation into four types in F2:
Type
Description
Trigger Timing
appear
The entrance animation when the chart is first loaded.
first time calling chart.render()
enter
The entrance animation when the chart is re-rendered after the change of data.
chart.changeData(data)
update
The update animation when the chart is re-rendered and the chart's shapes' status  is updated after the change of the data.
chart.changeData(data)
leave
The destroy animation when the chart's shapes are destroyed after the change of the data
chart.changeData(data)
Methods
chart.animate(false)
Close the chart's animation.
chart.<geomType>().animate(config)
Animation configuration for geometry.
chart.line().animate({
  appear: {
    animation: 'fadeIn',
    duration: 1000
  },
  update: false
});
Parameters:
config: Object / false. 
         If config's value is false, means close the animation for the geometry. 
         If config is an object, the properties can configure include:
Name
Type
Description
appear
Object / Boolean
Configuration for appear animation. If appear is false, means close the appear animation for the geometry.
enter
Object / Boolean
Configuration for enter animation. If enter is false, means close the enter animation for the geometry.
update
Object / Boolean
Configuration for update animation. If update is false, means close the update animation for the geometry.
leave
Object / Boolean
Configuration for leave animation. If leave is false, means close the leave animation for the geometry.
The configurable properties for appear, enter, update and leave are as follows:
Name
Type
Description
animation
String / Function
It is the animation action which can be specific with a string, in this way, you are using the animation provided by F2 (see below). Or be a Function for customizing.
easing
String / Function
easing action for animation.You can use the default easing functions provided by F2 or pass the function directly, see callback.
delay
Number / Function
delay time for animation, in millisecond.You can specify delay time directly or pass a callback.
duration
Number
duration of the animation, in millisecond.
Example:
{
  appear: {
    animation: 'fadeIn',
    easing: 'elasticIn', 
    delay: 1000, 
    duration: 600
  },
  update: false
}
Default Animations
 The animations provided by default are shown below:
Name
Demo
​
groupWaveIn
​​
​​
​
​
groupScaleInX
​​
​​
​
​
groupScaleInY
​​
​ 
​
​
groupScaleInXY
​​
​​
​
​
shapesScaleInX
​​
​​
​
shapesScaleInY
​​
​​
​
shapesScaleInXY
​​
​​
​
fadeIn
​​
​​
​
animation callback
Animation action can also be a callback.
 /**
   * Animation callback
   * @param  {Shape} shape       shape of the animation
   * @param  {Object} animateCfg configuration of the animation, such as easing, duration, etc.
   * @param  {Coord} coord       current coordinate object           
   */
  animation: (shape, animateCfg, coord) {}
Default easing
The default easing functions are: 
linear
quadraticIn
quadraticOut 
quadraticInOut
cubicIn
cubicOut
cubicInOut
elasticIn 
elasticOut
elasticInOut
backIn
backOut
backInOut
bounceIn
bounceOut
bounceInOut
For animation effect of each easing function, see http://sole.github.io/tween.js/examples/03_graphs.html.
easing callback
easing can also be a callback.
easing(t) {}
Example:
easing: (t) => {
  return Math.sqrt(1 - --t * t);
}
delay callback
/**
 * return the delay of the animation
 * @param  {Number} index      index of the shape, same as the shape's order of the data record in data set.
 * @param  {String} id         id of current shape
 * @return {Number}            delay of the animation, in millisecond
 */
delay(index, id) {}
shape.animate()
We also provide a method called animate for Shape instance to act the specific animation. See below for usage:
shape.animate()
  .to({
    attrs: {Object}, // the final graph attributes of the shape
    easing: {String} || {Function}, // easing function
    duration: {Number}, // duration of the animation, in millisecond
    delay: {Number} // delay time of the animation, in millisecond
  }) // animation action
  .onStart(function() {
    // callback when animation starts
  })
  .onUpdate(function() {
    // callback during the animation
  })
  .onEnd(function() {
    // callback when animation ends
  })
  .onFrame(function(t) {
    // callback for animation's every frame, `t` ranges from 0 to 1.
  });
Example
See demo here.