tatween
tatween is a JavaScript library providing a block-based animation API.
Block-Based Animations
Animations block are a way to express animations in an imperative way allowing for a better flexibility.
They are used in the Apple cocoa framework
That is, the idea is to enter a special scope where all the values set are animated.
Under the hood the library is using ES6-Proxy to listen for values change inside the anomation scope.
Examples
var square = document.getElementById("my_div").style;
// The code inside the block only run once.
// Here `square` in the original one wrapped by a Proxy
tatween(1000, Easing.Bounce.Out, (square /* Proxy wrapped element */) => {
/*
This block define the "end values".
tatween will tween them from their initial values to the end values described here
*/
/* Set the end value for top and width. */
square.top = "0px";
square.width = "150px";
/*
Add 200 to the initial left value.
Here, it's the same than doing `square.left = "250px"`
*/
square.left += 200;
}, square /* original element */);
Swap the position of two elements. Just swap their left properties.
tatween(3000, Easing.Elastic.Out, (square_one, square_two) => {
// Swap the left of the two element using destructuring array.
[square_one.left, square_two.left] = [square_two.left, square_one.left]
}, square_one, square_two); // Give any number of elements
Online demos
Usage
install:
$ npm install tatween
import tatween.js:
import { tatween, Easing } from 'tatween'Animate any property (really anything as long as it's backed by a number)
tatween(1000 /* duration in ms */, Easing.Bounce.Out /* Easing function */, (obj_A, obj_B, obj_C) => {
// Animate anything from obj_A/obj_B/obj_C :
// obj_A.width = "42px";
// obj_B.left = 30;
// obj_C.top = obj_A.top
}, obj_A, obj_B, obj_C);Available Easing function :
Linear.None
Quadratic.In
Quadratic.Out
Quadratic.InOut
Cubic.In
Cubic.Out
Cubic.InOut
Quartic.In
Quartic.Out
Quartic.InOut
Quintic.In
Quintic.Out
Quintic.InOut
Sinusoidal.In
Sinusoidal.Out
Sinusoidal.InOut
Exponential.In
Exponential.Out
Exponential.InOut
Circular.In
Circular.Out
Circular.InOut
Elastic.In
Elastic.Out
Elastic.InOut
Back.In
Back.Out
Back.InOut
Bounce.In
Bounce.Out
Bounce.InOut
License
Copyright 2021 Anthony Catel. All rights reserved. Use of this source code is governed by a MIT license that can be found in the LICENSE file.