@balogunofafrica/react-native-skeleton-content-nonexpo v1.0.0

React Native Skeleton Content Nonexpo

This a fork of this package, it resolves the issue with using it with reanimated and removes the hard requirement on redash

React native Skeleton Content, a simple yet fully customizable component made to achieve loading animation in a Skeleton-style. Works in both iOS and Android.

New Features

• The package has been rewritten to Hooks and is using the declarative react-native-reanimated package for animations
• It finally supports percentages dimensions for bones, for any type of animation!

• React Native Skeleton Content
  • Installation
  • Usage
  • Props
  • Examples
  • Playground

Installation

npm install @balogunofafrica/react-native-skeleton-content-nonexpo

or

yarn add @balogunofafrica/react-native-skeleton-content-nonexpo

This package requires the react-native-linear-gradient package, make sure it's installed and working on your project.

Also install the following peer dependencies as the package depends on them. We prefer you install these dependencies inorder to prevent double instance errors.

npm install react-native-reanimated

or

yarn add react-native-reanimated

Usage

1. Import react-native-skeleton-content:

import SkeletonContent from 'react-native-skeleton-content-nonexpo';

2. Once you create the SkeletonContent, you have two options:

• Child Layout : The component will figure out the layout of its bones with the dimensions of its direct children.
• Custom Layout : You provide a prop layout to the component specifying the size of the bones (see the Examples section below). Herunder is the example with a custom layout. A key prop is optional but highly recommended.

export default function Placeholder() {
  return (
    <SkeletonContent
      containerStyle={{ flex: 1, width: 300 }}
      isLoading={false}
      layout={[
        { key: 'someId', width: 220, height: 20, marginBottom: 6 },
        { key: 'someOtherId', width: 180, height: 20, marginBottom: 6 }
      ]}
    >
      <Text style={styles.normalText}>Your content</Text>
      <Text style={styles.bigText}>Other content</Text>
    </SkeletonContent>
  );
}

3. Then simply sync the prop isLoading to your state to show/hide the SkeletonContent when the assets/data are available to the user.

export default function Placeholder() {
  const [loading, setLoading] = useState(true);
  return (
    <SkeletonContent
      containerStyle={{ flex: 1, width: 300 }}
      isLoading={isLoading}
      {...otherProps}
    />
  );
}

Props

Note: The Easing type function is the one provided by react-native-reanimated, so if you want to change the default you will have to install it as a dependency.

Examples

See the playground section to experiment : 1 - Changing the direction of the animation (animationDirection prop) :

export default function Placeholder() {
  return (
    <SkeletonContent
      containerStyle={{ flex: 1, width: 300 }}
      animationDirection="horizontalLeft"
      isLoading={true}
      // ...
    />
  );
}

2 - Changing the colors and switching to "pulse" animation (boneColor, highlightColor and animationType prop) :

export default function Placeholder() {
  return (
    <SkeletonContent
      containerStyle={{ flex: 1, width: 300 }}
      boneColor="#121212"
      highlightColor="#333333"
      animationType="pulse"
      isLoading={true}
      // ...
    />
  );
}

3 - Customizing the layout of the bones (layout prop) :

export default function Placeholder() {
  return (
    <SkeletonContent
      containerStyle={{ flex: 1, width: 300 }}
      animationDirection="horizontalLeft"
      layout={[
        // long line
        { width: 220, height: 20, marginBottom: 6 },
        // short line
        { width: 180, height: 20, marginBottom: 6 }
        // ...
      ]}
      isLoading={true}
      // ...
    />
  );
}