86 lines
3.1 KiB
JavaScript
86 lines
3.1 KiB
JavaScript
import { useContext, useRef, useInsertionEffect } from 'react';
|
|
import { animateValue } from '../animation/animators/MainThreadAnimation.mjs';
|
|
import { MotionConfigContext } from '../context/MotionConfigContext.mjs';
|
|
import { useIsomorphicLayoutEffect } from '../utils/use-isomorphic-effect.mjs';
|
|
import { useMotionValue } from './use-motion-value.mjs';
|
|
import { isMotionValue } from './utils/is-motion-value.mjs';
|
|
import { frame, frameData } from '../frameloop/frame.mjs';
|
|
|
|
function toNumber(v) {
|
|
if (typeof v === "number")
|
|
return v;
|
|
return parseFloat(v);
|
|
}
|
|
/**
|
|
* Creates a `MotionValue` that, when `set`, will use a spring animation to animate to its new state.
|
|
*
|
|
* It can either work as a stand-alone `MotionValue` by initialising it with a value, or as a subscriber
|
|
* to another `MotionValue`.
|
|
*
|
|
* @remarks
|
|
*
|
|
* ```jsx
|
|
* const x = useSpring(0, { stiffness: 300 })
|
|
* const y = useSpring(x, { damping: 10 })
|
|
* ```
|
|
*
|
|
* @param inputValue - `MotionValue` or number. If provided a `MotionValue`, when the input `MotionValue` changes, the created `MotionValue` will spring towards that value.
|
|
* @param springConfig - Configuration options for the spring.
|
|
* @returns `MotionValue`
|
|
*
|
|
* @public
|
|
*/
|
|
function useSpring(source, config = {}) {
|
|
const { isStatic } = useContext(MotionConfigContext);
|
|
const activeSpringAnimation = useRef(null);
|
|
const value = useMotionValue(isMotionValue(source) ? toNumber(source.get()) : source);
|
|
const latestValue = useRef(value.get());
|
|
const latestSetter = useRef(() => { });
|
|
const startAnimation = () => {
|
|
/**
|
|
* If the previous animation hasn't had the chance to even render a frame, render it now.
|
|
*/
|
|
const animation = activeSpringAnimation.current;
|
|
if (animation && animation.time === 0) {
|
|
animation.sample(frameData.delta);
|
|
}
|
|
stopAnimation();
|
|
activeSpringAnimation.current = animateValue({
|
|
keyframes: [value.get(), latestValue.current],
|
|
velocity: value.getVelocity(),
|
|
type: "spring",
|
|
restDelta: 0.001,
|
|
restSpeed: 0.01,
|
|
...config,
|
|
onUpdate: latestSetter.current,
|
|
});
|
|
};
|
|
const stopAnimation = () => {
|
|
if (activeSpringAnimation.current) {
|
|
activeSpringAnimation.current.stop();
|
|
}
|
|
};
|
|
useInsertionEffect(() => {
|
|
return value.attach((v, set) => {
|
|
/**
|
|
* A more hollistic approach to this might be to use isStatic to fix VisualElement animations
|
|
* at that level, but this will work for now
|
|
*/
|
|
if (isStatic)
|
|
return set(v);
|
|
latestValue.current = v;
|
|
latestSetter.current = set;
|
|
frame.update(startAnimation);
|
|
return value.get();
|
|
}, stopAnimation);
|
|
}, [JSON.stringify(config)]);
|
|
useIsomorphicLayoutEffect(() => {
|
|
if (isMotionValue(source)) {
|
|
return source.on("change", (v) => value.set(toNumber(v)));
|
|
}
|
|
}, [value]);
|
|
return value;
|
|
}
|
|
|
|
export { useSpring };
|