KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Animation.play(): animaties starten en hervatten

Animation.play() start een bestaande animatie of hervat deze. De methode maakt geen nieuwe animatie en retourneert geen promise.

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

animation.play()

animation.play() accepteert geen argumenten en retourneert undefined. Bij een animatie op de tijdlijn van het document (document.timeline), zoals in het voorbeeld, behoudt play() bij een positieve effectieve afspeelsnelheid de huidige positie als de huidige tijd niet negatief is en vóór het einde van het effect ligt. Ligt de huidige tijd bij die snelheid op of voorbij het einde van het effect, dan zet play() de animatie terug naar het begin, ook als deze gepauzeerd is.

Na een aanroep van updatePlaybackRate() kan de effectieve afspeelsnelheid die play() gebruikt, afwijken van playbackRate: als een snelheidswijziging nog niet is toegepast, gebruikt play() de nieuwe waarde. Op de tijdlijn van het document kan zo’n nog niet toegepaste negatieve waarde er dus voor zorgen dat play() vanaf tijdstip nul naar het einde van een effect met een eindige duur springt, ook als playbackRate nog een positieve waarde aangeeft.

Het starten van het afspelen kan wachten op een asynchrone taak. animation.ready geeft aan dat de animatie klaar is, terwijl animation.finished aangeeft dat deze is voltooid. De aanroep van play() zelf wacht op geen van beide.

Dit is een Web API, geen ECMAScript-functie. Controleer de ondersteuning in de doelbrowser; Node 24 toont die niet aan. Het voorbeeld laat zien hoe de animatie wordt hervat vanaf een tijdstip binnen het tijdsbereik van het effect, niet wat er gebeurt als een wijziging naar een negatieve snelheid nog niet is toegepast. Het gebruikt een effect zonder doelelement en tekent niets.

Voorbeelden

const effect = new KeyframeEffect(null, [], { duration: 1000 });
const animation = new Animation(effect, document.timeline);

animation.currentTime = 400;
const result = animation.play();
console.log(result === undefined, animation.currentTime);

animation.finish();
console.log(animation.playState, animation.currentTime);

Resultaat

true 400
finished 1000

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.

Bronnen