React-native-animateable-text NPM

react-native-animateable-text

A fork of React Native's <Text/> component that supports Animated Values as text!

Compatibility

Installation

yarn add react-native-animateable-text
npx pod-install

Usage (Reanimated 2)

Note about Reanimated 2: The library does not work with Alpha 9 until RC1. Make sure to update to RC2 or later!

Use it the same as a <Text/> component, except instead of passing the text as a child node, pass it using the text props.

import AnimateableText from 'react-native-animateable-text';

const Example: React.FC = () => {
  const text = useSharedValue('World');

  const animatedText = useDerivedValue(() => `Hello ${text.value}`);
  const animatedProps = useAnimatedProps(() => {
    return {
      text: animatedText.value,
    };
  });

  return (
    <AnimateableText
      animatedProps={animatedProps}
      // same other props as Text component
    />;
};

Usage (Reanimated 1)

import AnimateableText from 'react-native-animateable-text';

const Example: React.FC = () => {
  const text = useMemo(() => new Animated.Value('World'), []);

  const animatedText = useMemo(() => concat('Hello', text));

  return (
    <AnimateableText
      text={animatedText}
      // same other props as Text component
    />;
};

OMG, why would you build this?

We want to animate numbers based on gestures as fast as possible, for example for charts displaying financial data. Updating native state is too slow and not feasible for a smooth experience. Using createAnimatedComponent doesn't allow you to animate the text since the children of Text are separate nodes rather than just props.

The best way so far has been to use the <ReText> component from react-native-redash, which allows you to render a string from a Reanimated Text node. However, under the hood, it uses a <TextInput/> and animates it's value prop.

This naturally comes with a few edge cases, for example: