kute.js

A minimal native Javascript tweening engine with jQuery plugin, forked from tween.js. Since most of web developers don't actually use yoyo, repeat, play/pause/resume/timeline/whatever or tweening array values (processed with array interpolation functions), I've removed them, for simplicity and performance.

kute.js is like a merge of my own jQueryTween with tween.js, but generally it's a much more smarter build. You link the script at your ending </body> tag and write one line to do just about any animation you can think of.

Also worth noting that the script does it's job without any dependency like plugins or other functionality.

CDN

Thanks to jsdelivr, we have CDN link here.

Basic Usage

At a glance, you can write one line and you're done.

//vanilla js
new KUTE.Animate(el,options);

//with jQuery plugin
$('selector').Kute(options);

Advanced Usage

Quite easily, you can write 'bit more lines and you're making the earth go round.

//vanilla js
new KUTE.Animate(el, {
  //options
    from	: {
      translate: {x:0},
      opacity: 1
    },
    to	: {
      translate: {x:150},
      opacity: 0
    }, 
    duration: 500,
    delay	: 0,
    easing	: 'exponentialInOut',
    start			: functionOne, // run function when tween starts 
    finish			: functionTwo, // run function when tween finishes
    special			: functionThree // run function while tween runing    
  }
);

//with jQuery plugin
$('selector').Kute({
  //options
    from	: {
      translate: {x:0},
      opacity: 1
    },
    to	: {
      translate: {x:150},
      opacity: 0
    }, 
    duration: 500,
    delay	: 0,
    easing	: 'exponentialInOut',
    start			: functionOne, // run function when tween starts 
    finish			: functionTwo, // run function when tween finishes
    special			: functionThree // run function while tween runing    
  }
);

Full distribution (12Kb min)

It does most of the animation work you need. Supported properties:

size: width and height
colors: text color and backgroundColor (accepts values as HEX, RGB, RGBA, but the output color is always HEX )
transform: translate3D, scale, rotateX, rotateY, rotateZ (not using rotate3D because processing values are quite a hustle)
position: top, left (ideal for IE9- translate3D(left,top,0) fallback, they require proper use of position: relative and/or position: absolute)
zoom: for scale fallback on IE8
backgroundPosition
window scroll

Base Distribution (9Kb min)

This distribution is slightly lighter and more suitable for most projects. It covers:

size: width and height
transform: translate3D, scale, rotateX, rotateY, rotateZ
position: top, left (see above for more info on the properties)
zoom: for scale fallback on IE8
window scroll

#jQuery Plugin That's right, there you have it, just a few bits of code to bridge the awesome kute.js to your jQuery powered projects/apps. The plugin can be found in the /dist folder.

What else it does

computes option values properly according to their measurement unit (px,%,deg,etc)
properly handles IE10+ 3D transform when elements have a perspective, else the animation won't run
it converts RGBA & HEX colors to RGB and tweens the inner values, then ALWAYS updates color via HEX; no support for RGBA
properly replaces top, centered or any other background position with proper value to be able to tween
for most supported properties it reads the current element style property value as initial value (via currentStyle || getComputedStyle)
allows you to add 3 different callbacks: start, special, finish, and they can be set as tween options (so no more nested functions are invoked as object attributes)
since translate3D is best for performance, kute.js will always uses it
accepts "nice & easy string" easing functions, like linear or exponentialOut (removes the use of the evil eval, making development, safer easier and closer to development standards :)
uses 31 easing functions, all Robert Penner's easing equations
like mentioned above, for IE8 zoom is used for transform: scale(0.5), it's not perfect as the object moves from it's floating point to the middle, and some left & top adjustments can be done, but to keep it simple and performance driven, I leave it as is, it's better than nothing.
generally it's using for -webkit- prefix for Safari and older webkit browsers for CSS powered transitions.

Browser Support

Since most modern browsers can handle pretty much everything, legacy browsers need some help, so give them polyfills.io. Also kute.js needs to know when doing stuff for IE9- like my other scripts here, I highy recommend Paul Irish's conditional stylesheets guides to add ie ie[version] to your site's HTML tag.

Demo

coming soon..

License

MIT License

ukris/kute.js