Spring animation

In React apps, when you can afford adding around 10kB of gzipped JS, you can reach out for libraries such as react-spring (or the original, and smaller react-motion). For my little lightweight website 10kB is unfortunately way too much. So I wrote a smaller spring library.

First, let's go through the core requirements that I felt were crucial to a spring component:

  • configurability of mass, tension, friction etc
  • Animated.div Component with a declarative API, but a direct DOM manipulation behind the scene.
  • hooks API such as useSpring(animationProperties, springConfig)

Instead of re-implementing the velocity calculation, I've forked the core frame loop function from react-spring's frameLoop.ts update function and trimmed it down to only support spring animations (e.g. no easing/time based support).

The other important feature is the ability to update the DOM node without triggering a Component state update. For its API, I wanted the ability to have the short-hand notation of <Animated.div /> over <Animated type="div" /> – the same notation as react-spring and emotionjs

Thanks to React.forwardRef this is a simple API to implement. Here's one implementation:

['div', 'span', /* 100+ more hard-coded tags here */].forEach(element => Animated[element] = React.forwardRef());

Luckily ES6 metaprogramming ability (Proxy) comes to the rescue (one of the very few times where using ES6 Proxy came in very handy while building UIs...). It saves a few kB :). The downside is we lose the transpile-time error feedback, and the IDE intellisense – worsened DX for a slightly better UX.

const AnimatedInstances = {}; export default new Proxy(AnimatedBase, { get(obj, type) { return AnimatedInstances[type] || (AnimatedInstances[type] = React.forwardRef(); } });

One thing to note: AnimatedInstances is there so we don't constantly create new components with React.forwardRef().

Let's dive into a simple example – I'll shamelessly borrow the example react-spring has on their documentation page.

import {Animated, interpolate, useSpring} from '@stilva/spring'; function Square({}) { const {x, y} = useMouse(); const [animatedProps, setAnimatedProps] = useSpring({ x: 1, y: 0 }, { mass: 3, tension: 170, friction: 14 }); useEffect(() => { setAnimatedProps({ x, y }); }, [x, y]) return <div className="wrapper"> <Animated.div className="square" style={{ '--transform': interpolate(animatedProps, ({x, y}) => `rotateX(${-20 * y.lastPosition}deg) rotateY(${20 * x.lastPosition}deg)`), }} > {Date.now()} </Animated.div> </div> }

And here's what we get (move your mouse around the square):


A few things to note:

  • useMouse throttles the callbacks to once every 50ms.
  • The square has Date.now() so you can see how often the state updates.
  • Animatmed.div can animate independently of state updates, and keeps track of animations
  • This is probably not the best example, since you could achieve similar results with a mixture of CSS transition and the same useMouse hook I've used.