Simple and minimal animation library

This is a small and minimalistic animation library. You can only animate single value properties like opacity, width or height for example. If you want to animate properties like margin, you have to use every property separately as margin-top, margin-right etc.

If you find any issues or bugs with this package, feel free to open an issue on github and i will try to resolve it as fast as possible. Or simply fix the bugs yourself and open a pull request.

Installation

$ npm install simple-animate --save

Importing

// ES6 Module
import { polyfill, animate, animateAsPromise } from 'simple-animate';

// CommomJS
const SimpleAnimate = require('simple-animate');

API

• animate(el, props [, duration [, easing] [, callback [, forceCallback] ] ] ) ⇒ Function
• animateAsPromise(el, props [, duration [, easing] ]) ⇒ Promise
• polyfill([animatePropName [, animateAsPromisePropName] ]) ⇒ undefined

animate(el, props [, duration [, easing] [, callback [, forceCallback] ] ])

Animate an element to target props.

Returns: Function - Returns a function which cancels the animation if called

| Param | Type | Default | Description | | --- | --- | --- | --- | | el | Element | | The Element to animate | | props | Object | | The properties & values you want it to look like | | [duration] | Number | 400 | Duration of the animation in ms | [easing] | String | linear | Easing to be used | [callback] | function | | Callback function to execute when the animation finished | | [forceCallback] | boolean | false | If true will force the callback to be executed even if the animation got canceled |

Example

// ES6 Module
import { animate } from 'simple-animate';

// CommonJS
const animate = require('simple-animate').animate;

const div = document.querySelector('div');

// Animate div to target props without a callback
animate(div, { width: '200px', height: '100px' }, 500, 'easeInOutCubic');


// Animate div to target props with a callback
animate(div, { width: '300px', height: '200px' }, 500, 'easeInOutCubic', function () {
    console.log('Animation finished, YAY!');
});

// Animate div to target props with a callback, but animation gets canceled and callback will not be reached
const cancelAnimation = animate(div, { width: '200px', height: '100px' }, 500, 'easeInOutCubic', function () {
    console.log('This will not be logged');
});

// Cancel animation after 200ms
setTimeout(cancelAnimation, 200);

// Animate div to target props with a callback, animation will be canceled but callback will be executed anyway
const cancelAnimation = animate(div, { width: '200px', height: '100px' }, 500, 'easeInOutCubic', function () {
    console.log('Forced callback execution');
}, true);

// Cancel animation after 200ms
setTimeout(cancelAnimation, 200);

animateAsPromise(el, props [, duration [, easing] ])

This is the same as animate, but returns a Promise. This looks nicer, but can't be canceled.

Returns: Promise - Returns a Promise which resolves when the animation ends.

| Param | Type | Default | Description | | --- | --- | --- | --- | | el | Element | | The Element to animate | | props | Object | | The properties & values you want it to look like | | [duration] | Number | 400 | Duration of the animation in ms | [easing] | String | linear | Easing to be used

Example

// ES6 Module
import { animateAsPromise } from 'simple-animate';

// CommonJS
const animateAsPromise = require('simple-animate').animateAsPromise;

const div = document.querySelector('div');

// Animate div to target props without a callback
animateAsPromise(div, { width: '200px', height: '100px' }, 500, 'easeInOutCubic');

// Animate div to target props with a callback
animateAsPromise(div, { width: '300px', height: '200px' }, 500, 'easeInOutCubic')
    .then(function () {
        console.log('Animation finished, YAY!');
    });

// Animate div to target props with default duration & easing
animateAsPromise(div, { width: '300px', height: '200px' })
    .then(function () {
        console.log('Animation finished, YAY!');
    });

polyfill([animatePropName [, animateAsPromisePropName] ])

This function will add animate and animateAsPromise to the Element.prototype. The functions animate and animateAsPromise can be used as shown above with one difference. There will be no need to use the el property, since that will be taken care of :)

| Param | Type | Default | Description | | --- | --- | --- | --- | | animatePropName | String | customAnimate | Propertyname you want to allocate on the Element.prototype for the animate function | | animateAsPromisePropName | String | customAnimateAsPromise | Propertyname you want to allocate on the Element.prototype for the animateAsPromise function |

Example

// ES6 Module
import { polyfill } from 'simple-animate';

// CommonJS
const polyfill = require('simple-animate').polyfill;

// This adds customAnimate and customAnimateAsPromise to Element.prototype
polyfill();

// Fetching Element from DOM
const div = document.querySelector('div');

// Normal animation
div.customAnimate({ width: '200px', height: '100px' }, 500, 'easeInOutCubic');

// Animation which returns a promise
div.customAnimateAsPromise({ width: '300px', height: '200px' }, 500, 'easeInOutCubic')
    .then(function () {
        console.log('Animation finished, YAY!');
    });

Easings

All credit for the easing function goes to gre
Available easings:

• linear
• easeInQuad
• easeOutQuad
• easeInOutQuad
• easeInCubic
• easeOutCubic
• easeInOutCubic
• easeInQuart
• easeOutQuart
• easeInOutQuart
• easeInQuint
• easeOutQuint
• easeInOutQuint

MIT © Christian Sany