React Native Reanimated

React Native Reanimated is an alternative animation library to the LayoutAnimation API provided by React Native.

We support view animations and most of layout animations.

Layout Animations

For layout animations, similarly to the React Native API, you need to call prepareLayoutAnimationRender() before removing or inserting an element that you want to animate.

Hooks

Usage

You can use hooks such as useSharedValue as you would in a normal view. The difference is that since views get recycled, a value can transfer to an unrelated component. You will need to reset such values when a view is recycled - for this, you can pass a prop that uniquely identifies the cell (such as id of an item) and run a callback via useEffect. You can take inspiration from the following example:

import React, { useEffect } from "react";
import Animated, { useSharedValue } from "react-native-reanimated";
import { FlashList } from "@shopify/flash-list";

const Item = ({ item }: { item: { id: string } }) => {
  const myValue = useSharedValue(0);
  useEffect(() => {
    // Reset value when id changes (view was recycled for another item)
    myValue.value = 0;
  }, [item.id, myValue]);
  return <Animated.View />;
};

const MyList = () => {
  return <FlashList renderItem={Item} />;
};

Performance

If you use hooks that accept a dependencies array, make sure to leverage it and include only the minimal set of dependencies.