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.