Skip to content
Javascript tweening engine
Branch: master
Clone or download
Pull request Compare This branch is 1 commit ahead, 95 commits behind tweenjs:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets Crop and resize the aframe logo. Aug 2, 2016
docs
examples Remove unnecessary code from the 01_bars.html example. Dec 11, 2016
src fix: correct the preserve flag behavior Jun 21, 2017
test
.gitignore feat: update contributing with proper url, and also HOPEFULLY fixes s… Jan 26, 2017
.npmignore
.travis.yml feat: update .travis.yml node_js engine version Jan 24, 2017
CODE_OF_CONDUCT.md Add code of conduct. Closes tweenjs#247 Jun 11, 2017
CONTRIBUTING.md Add code of conduct. Closes tweenjs#247 Jun 11, 2017
LICENSE r6 Apr 10, 2012
README.md fix: fix typo in img src for npm badge-it was pointing to the old pac… Jun 30, 2017
bower.json docs: fix wrong instructions for bower, fixes bug tweenjs#205. Still … Sep 29, 2015
package.json Merge branch 'master' of github.com:tweenjs/tween.js Jun 15, 2017

README.md

tween.js

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

NPM Version NPM Downloads Travis tests Flattr this CDNJS

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:

<script src="js/Tween.js"></script>

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

<script src="https://cdnjs.cloudflare.com/ajax/libs/tween.js/16.3.5/Tween.min.js"></script>

See tween.js for more versions.

More advanced users might want to...

Use npm

npm install @tweenjs/tween.js

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

var TWEEN = require('@tweenjs/tween.js');

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

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

bower install @tweenjs/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:

bower install @tweenjs/tweenjs#v16.3.0

Then reference the library source:

<script src="bower_components/@tweenjs/tweenjs/src/Tween.js"></script>

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

Examples

Custom functions Custom functions
(source)
Stop all chained tweens Stop all chained tweens
(source)
Yoyo Yoyo
(source)
Relative values Relative values
(source)
Repeat Repeat
(source)
Dynamic to Dynamic to
(source)
Array interpolation Array interpolation
(source)
Video and time Video and time
(source)
Simplest possible example Simplest possible example
(source)
Graphs Graphs
(source)
Black and red Black and red
(source)
Bars Bars
(source)
hello world hello world
(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:

npm install

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

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 pull request (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

A-Frame VR MOMA Inventing Abstraction 1910-1925 Web Lab MACCHINA I Minesweeper 3D ROME WebGL Globe Androidify The Wilderness Downtown Linechart

You can’t perform that action at this time.