React Native Animated Ellipsis

A simple, customizable animated dots component ideal for loading screens in React Native apps (forked from adorableio/react-native-animated-ellipsis - not maintained).

Fixed Issues

1. useNativeDriver was not specified. This is a required option and must be explicitly set to true or false
2. undefined is not an object evaluating _reactNative.Text.propTypes.style - (Deprecated prop types)

Installation

# yarn
yarn add @zfloc/react-native-animated-ellipsis

# npm
npm i @zfloc/react-native-animated-ellipsis

Importing

import AnimatedEllipsis from '@zfloc/react-native-animated-ellipsis';

Usage

Just include the component in the output of any other component like this:

render() {
  return (
    <View>
      <Text>
        Loading
        <AnimatedEllipsis />
      </Text>
    </View>
  );
}

which will get you something like this:

Props

Customize the number of dots, animation speed, and style using these props:

| Property | Description | |----------|-------------| | numberOfDots | The number of dots you'd like to show. Defaults to 3. | | animationDelay | The length in milliseconds of each phase of the animated. Defaults to 300. | | minOpacity | The minimum opacity for the dots. Defaults to 0. | | style | CSS to apply to the dots. It accepts any styles that a normal <Text /> component can take. | | useNativeDriver | Specify true or false. Defaults to true. |

More Examples

<AnimatedEllipsis numberOfDots={10} />

<AnimatedEllipsis 
  numberOfDots={4}
  animationDelay={150}
  style={{
    color: 'red',
    fontSize: 72,
  }}
/>

<AnimatedEllipsis 
  numberOfDots={3}
  minOpacity={0.4}
  animationDelay={200}
  style={{
    color: '#94939b',
    fontSize: 100,
    letterSpacing: -15,
  }}
/>