What is @tweenjs/tween.js?
@tweenjs/tween.js is a simple but powerful tweening engine for JavaScript. It allows you to create smooth animations by interpolating between values over time. This can be used for animating properties of objects, such as position, scale, rotation, and more.
What are @tweenjs/tween.js's main functionalities?
Basic Tweening
This code demonstrates basic tweening where an object's properties (x and y coordinates) are animated from one state to another over a duration of 1000 milliseconds.
const TWEEN = require('@tweenjs/tween.js');
let coords = { x: 0, y: 0 };
let tween = new TWEEN.Tween(coords)
.to({ x: 100, y: 100 }, 1000)
.onUpdate(() => {
console.log(coords);
})
.start();
function animate(time) {
requestAnimationFrame(animate);
TWEEN.update(time);
}
requestAnimationFrame(animate);
Easing Functions
This code demonstrates the use of easing functions to create more natural motion. The Quadratic.Out easing function is used to slow down the animation towards the end.
const TWEEN = require('@tweenjs/tween.js');
let coords = { x: 0, y: 0 };
let tween = new TWEEN.Tween(coords)
.to({ x: 100, y: 100 }, 1000)
.easing(TWEEN.Easing.Quadratic.Out)
.onUpdate(() => {
console.log(coords);
})
.start();
function animate(time) {
requestAnimationFrame(animate);
TWEEN.update(time);
}
requestAnimationFrame(animate);
Chaining Tweens
This code demonstrates chaining tweens, where one tween starts after another finishes. The x coordinate is animated first, followed by the y coordinate.
const TWEEN = require('@tweenjs/tween.js');
let coords = { x: 0, y: 0 };
let tween1 = new TWEEN.Tween(coords)
.to({ x: 100 }, 1000);
let tween2 = new TWEEN.Tween(coords)
.to({ y: 100 }, 1000);
tween1.chain(tween2);
tween1.start();
function animate(time) {
requestAnimationFrame(animate);
TWEEN.update(time);
}
requestAnimationFrame(animate);
Other packages similar to @tweenjs/tween.js
gsap
GSAP (GreenSock Animation Platform) is a robust and high-performance JavaScript animation library. It offers more features and flexibility compared to @tweenjs/tween.js, including timeline management, advanced easing, and support for SVG animations.
animejs
Anime.js is a lightweight JavaScript animation library with a simple API. It supports various types of animations, including CSS properties, SVG, DOM attributes, and JavaScript objects. It is more feature-rich and versatile compared to @tweenjs/tween.js.
popmotion
Popmotion is a functional, flexible JavaScript animation library. It provides a range of tools for creating animations and interactions, including physics-based animations. It offers more advanced features and flexibility compared to @tweenjs/tween.js.
tween.js
JavaScript (TypeScript) tweening engine for easy animations, incorporating optimised Robert Penner's equations.
More languages: English, 简体中文
<script src="https://cdnjs.cloudflare.com/ajax/libs/tween.js/20.0.0/tween.umd.js"></script>
<div id="box"></div>
<style>
#box {
background-color: deeppink;
width: 100px;
height: 100px;
}
</style>
<script>
const box = document.getElementById('box')
const coords = {x: 0, y: 0}
const tween = new TWEEN.Tween(coords, false)
.to({x: 300, y: 200}, 1000)
.easing(TWEEN.Easing.Quadratic.InOut)
.onUpdate(() => {
box.style.setProperty('transform', 'translate(' + coords.x + 'px, ' + coords.y + 'px)')
})
.start()
function animate(time) {
tween.update(time)
requestAnimationFrame(animate)
}
requestAnimationFrame(animate)
</script>
Try this example on CodePen
Installation
From CDN
Install from a content-delivery network (CDN) like in the above example.
From cdnjs:
<script src="https://cdnjs.cloudflare.com/ajax/libs/tween.js/20.0.0/tween.umd.js"></script>
Or from unpkg.com:
<script src="https://unpkg.com/@tweenjs/tween.js@^20.0.0/dist/tween.umd.js"></script>
Note that unpkg.com supports a semver version in the URL, where the ^
in the URL tells unpkg to give you the latest version 20.x.x.
Build and include in your project with script tag
Currently npm is required to build the project.
git clone https://github.com/tweenjs/tween.js
cd tween.js
npm install
npm run build
This will create some builds in the dist
directory. There are currently two different builds of the library:
- UMD :
tween.umd.js
- ES6 Module :
tween.es.js
You are now able to copy tween.umd.js into your project, then include it with
a script tag, which will add TWEEN to the global scope,
<script src="path/to/tween.umd.js"></script>
or import TWEEN as a JavaScript module,
<script type="module">
import * as TWEEN from 'path/to/tween.es.js'
</script>
where path/to
is replaced with the location where you placed the file.
With npm install
and import
from node_modules
You can add tween.js as an npm dependency:
npm install @tweenjs/tween.js
With a build tool
If you are using Node.js, Parcel, Webpack, Rollup, Vite, or another build tool, then you can now use the following to include tween.js:
import * as TWEEN from '@tweenjs/tween.js'
Without a build tool
You can import from node_modules
if you serve node_modules as part of your website, using an importmap
script tag. First, assuming node_modules
is at the root of your website, you can write an import map:
<script type="importmap">
{
"imports": {
"@tweenjs/tween.js": "/node_modules/@tweenjs/tween.js/dist/tween.es.js"
}
}
</script>
Now in any of your module scripts you can import it by its package name:
import * as TWEEN from '@tweenjs/tween.js'
Features
- Does one thing and one thing only: tween properties
- Doesn't take care of CSS units (e.g. appending
px
) - Doesn't interpolate colors
- Easing functions are reusable outside of Tween
- Can also use custom easing functions
Documentation
Examples
Tests
You need to install npm
first--this comes with node.js, so install that one first. Then, cd to tween.js
's (or wherever you cloned the repo) directory and run:
npm install
To run the tests run:
npm test
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. Any pull request (PR) needs to have updated passing tests for feature changes (or new passing tests for new features or fixes) in src/tests.ts
a PR to be accepted. See contributing for more information.
People
Maintainers: Joe Pea (@trusktr).
All contributors.
Projects using tween.js