tween.js

JavaScript tweening engine for easy animations, incorporating optimised Robert Penner's equations.

[![NPM Version][npm-image]][npm-url]
[![NPM Downloads][downloads-image]][downloads-url]
[![Travis tests][travis-image]][travis-url]
[![Flattr this][flattr-image]][flattr-url]
[![CDNJS][cdnjs-image]][cdnjs-url]

``javascript
var coords = { x: 0, y: 0 };
var tween = new TWEEN.Tween(coords)
.to({ x: 100, y: 100 }, 1000)
.onUpdate(function() {
console.log(this.x, this.y);
})
.start();

requestAnimationFrame(animate);

function animate(time) {
requestAnimationFrame(animate);
TWEEN.update(time);
}
`

Installation

Download the library and include it in your code:

`html

`

You can also reference a CDN-hosted version in your code, thanks to cdnjs. For example:

`html

`

See tween.js for more versions.

$3

#### Use npm

`bash
npm install tween.js
`

Then include the Tween.js module with the standard node.js require:

`javascript
var TWEEN = require('tween.js');
`

And you can use Tween.js as in all other examples--for example:

`javascript
var t = new TWEEN.Tween( / etc / );
t.start();
`

You will need to use a tool such as browserify to convert code using this style into something that can be run in the browser (browsers don't know about require).

#### Use bower

`bash
bower install tweenjs --save
`

or install an specific tag. They are git tags, and you can run git tag in the command line for a list if you have cloned the repository locally, or you can also check out the list in the tween.js tags page. For example, to install v16.3.0:

`bash
bower install tweenjs#v16.3.0
`

Then reference the library source:

`html

`

Features

* Does one thing and one thing only: tween properties
* Doesn't take care of CSS units (e.g. appending px)
* Doesn't interpolate colours
* Easing functions are reusable outside of Tween
* Can also use custom easing functions

Documentation

* User guide
* Tutorial using tween.js with three.js
* Also: libtween, a port of tween.js to C by jsm174

Examples

![Custom functions](http://tweenjs.github.io/tween.js/examples/12_graphs_custom_functions.html)
source
![Stop all chained tweens](http://tweenjs.github.io/tween.js/examples/11_stop_all_chained_tweens.html) source
![Yoyo](http://tweenjs.github.io/tween.js/examples/10_yoyo.html) source
![Relative values](http://tweenjs.github.io/tween.js/examples/09_relative_values.html) source
![Repeat](http://tweenjs.github.io/tween.js/examples/08_repeat.html) source
![Dynamic to](http://tweenjs.github.io/tween.js/examples/07_dynamic_to.html) source
![Array interpolation](http://tweenjs.github.io/tween.js/examples/06_array_interpolation.html) source
![Video and time](http://tweenjs.github.io/tween.js/examples/05_video_and_time.html) source
![Simplest possible example](http://tweenjs.github.io/tween.js/examples/04_simplest.html) source
![Graphs](http://tweenjs.github.io/tween.js/examples/03_graphs.html) source
![Black and red](http://tweenjs.github.io/tween.js/examples/02_black_and_red.html) source
![Bars](http://tweenjs.github.io/tween.js/examples/01_bars.html) source
![hello world](http://tweenjs.github.io/tween.js/examples/00_hello_world.html) source

Tests

You need to install npm first--this comes with node.js, so install that one first. Then, cd to tween.js's directory and run:

`bash
npm install
`

if running the tests for the first time, to install additional dependencies for running tests, and then run

`bash
npm test
``

every time you want to run the tests.

If you want to add any feature or change existing features, you must run the tests to make sure you didn't break anything else. If you send a PR to add something new and it doesn't have tests, or the tests don't pass, the PR won't be accepted. See contributing for more information.

People

Maintainers: mikebolt, sole.

All contributors.

Projects using tween.js


[npm-image]: https://img.shields.io/npm/v/tween.js.svg
[npm-url]: https://npmjs.org/package/tween.js
[downloads-image]: https://img.shields.io/npm/dm/tween.js.svg
[downloads-url]: https://npmjs.org/package/tween.js
[travis-image]: https://travis-ci.org/tweenjs/tween.js.svg?branch=master
[travis-url]: https://travis-ci.org/tweenjs/tween.js
[flattr-image]: https://api.flattr.com/button/flattr-badge-large.png
[flattr-url]: https://flattr.com/thing/45014/tween-js
[cdnjs-image]: https://img.shields.io/cdnjs/v/tween.js.svg
[cdnjs-url]: https://cdnjs.com/libraries/tween.js