react-native-animateable-text
    TypeScript icon, indicating that this package has built-in type declarations

    0.6.2 • Public • Published

    react-native-animateable-text

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

    Compatibility

    Animateable Text Version RN Version
    >= 0.6.0 >= 0.64
    >= 0.5.9 >= 0.63

    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:

    • Flicker: When changing values too fast, the text can be cut off and show an ellipsis. The problem gets worse the slower the device and the more congested the render queue is. Watch this GIF at 0.2x speed carefully:
    • Inconsistent styling: When styling a TextInput, you need to add more styles to make it align with the rest of your text. (Behavior in screenshot happens only on Android)

    • Lack of full capabilities: Not all props are available. With Animateable Text, you can use props that you cannot use on a TextInput, such as selectable, dataDetectorType or onTextLayout.

    Contributing

    See the contributing guide to learn how to contribute to the repository and the development workflow.

    Credits

    Written by Jonny Burger for our needs at Axelra.

    Thanks to Axelra for sponsoring my time to turn this into an open source project!



    We are a Swiss Agency specializing in React Native, caring even about the smallest of details.

    License

    MIT

    Install

    npm i react-native-animateable-text

    DownloadsWeekly Downloads

    898

    Version

    0.6.2

    License

    MIT

    Unpacked Size

    3.99 MB

    Total Files

    243

    Last publish

    Collaborators

    • avatar