animare/lib/module/variants/single.js

Advanced animation library for modern JavaScript.

import timeline from'./timeline.js';/**
 * Play a single animation.
 *
 * @param animation - animation options
 * @param onUpdateCallback - a callback function that is called on each animation frame
 * @returns an object that contains a bunch of useful methods and events
 *
 * @example
 * // Play a single animation with infinite repetition
 * const methods = animare.single({ to: 100, playCount: -1 }, info => console.log(info));
 */export default function single(animation,onUpdateCallback){const isInfinite=typeof animation.playCount==='number'&&animation.playCount<0;const animationOptions=[{...animation,name:'single',playCount:isInfinite?1:animation.playCount}];const timelineOptions={autoPlay:animation.autoPlay??true,timelinePlayCount:isInfinite?-1:1};const timelineReturnObj=timeline(animationOptions,info=>onUpdateCallback(info[0]),timelineOptions);const timelineUpdateValues=timelineReturnObj.updateValues;const updateValues=newValues=>{if('autoPlay'in newValues){timelineReturnObj.updateTimelineOptions({autoPlay:newValues.autoPlay});delete newValues.autoPlay;}if('playCount'in newValues){timelineReturnObj.updateTimelineOptions({timelinePlayCount:newValues.playCount});delete newValues.playCount;}timelineUpdateValues([{name:'single',...newValues}]);};const singleReturnObj=Object.assign(timelineReturnObj,{updateValues,animationsInfo:timelineReturnObj.animationsInfo[0]});return singleReturnObj;}