CKTIS / JavaScript
Animation — animaties in de browser besturen
Animation bestuurt het afspelen van een effect op een tijdlijn. Je kunt er een animatie mee starten, pauzeren en doorlopen, onafhankelijk van de definitie van de keyframes.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Animation(effect, timeline)
const animation = element.animate(keyframes, options);Animation bestuurt het afspelen; KeyframeEffect beschrijft keyframes en tijdsparameters, terwijl DocumentTimeline de tijdlijn levert. Dit is een Web-API en geen onderdeel van ECMAScript. Alleen de aanwezigheid van Node.js 24 toont niet aan dat deze API beschikbaar is.
new Animation(effect, timeline) start het afspelen niet automatisch; element.animate() maakt een animatie en speelt die af. De methoden play(), pause(), reverse() en cancel() besturen het afspelen. Op een documenttijdlijn staat currentTime voor milliseconden en kan de waarde null zijn.
ready geeft aan dat een wachtende afspeel- of pauzeerbewerking is voltooid; finished geeft aan dat het afspelen is afgelopen. Als je cancel() aanroept op een animatie die nog niet is voltooid en niet in de toestand idle staat, wordt haar openstaande finished-promise afgewezen met een AbortError. Handel die afwijzing af als je deze promise gebruikt. Een nieuw aangemaakte animatie in de toestand idle heeft een openstaande finished-promise, die open blijft als je cancel() aanroept terwijl de animatie in die toestand staat.
Het voorbeeld stelt de tijd in zonder het afspelen te starten: lineaire interpolatie levert een opacity van 0.5 op. Controleer of de gebruikte API’s beschikbaar zijn in de doelbrowser.
Voorbeelden
const box = document.createElement('div');
box.textContent = 'Animation';
document.body.append(box);
const effect = new KeyframeEffect(
box,
[{ opacity: 0 }, { opacity: 1 }],
{ duration: 1000, easing: 'linear', fill: 'both' }
);
const animation = new Animation(effect, document.timeline);
animation.currentTime = 500;
console.log(animation.currentTime);
console.log(getComputedStyle(box).opacity);
animation.cancel();
box.remove();Resultaat
500 0.5
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.