React Native library for detecting component visibility in the viewport
source link: https://reactnativeexample.com/react-native-library-for-detecting-component-visibility-in-the-viewport/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
React Native library for detecting component visibility in the viewport
React Native Viewport Detector
react-native-viewport-detector
is a library for monitoring the visibility of React Native components within the viewport. It provides a straightforward way to track whether a child component is currently visible to the user on the screen, based on a given percentage of its width and height within the viewport.
Features
- Determine if a React Native component is in the viewport based on a specified percentage of its dimensions.
- Simple and easy-to-use API for tracking component visibility.
- Suitable for various use cases, such as lazy loading, animations, or tracking user interactions.
Installation
To use react-native-viewport-detector
in your React Native project, you need to install it via npm or yarn:
npm install react-native-viewport-detector
# or
yarn add react-native-viewport-detector
Usage
The ViewPortDetectorProvider
component should be the first nested component and wrap a scrollable view in your screen to detect exactly the viewport position when user scrolls. If you don’t wrap your scrollview with the provider, the component will use the default viewport which is {x: 0, y: 0, width: SCREEN_WIDTH, height: SCREEN_HEIGHT}
import React, { useState } from "react";
import { SafeAreaView, ScrollView, StyleSheet, View } from "react-native";
import {
ViewPortDetector,
ViewPortDetectorProvider,
} from "react-native-viewport-detector";
function App(): JSX.Element {
return (
<SafeAreaView style={styles.container}>
<View style={styles.header} />
<ViewPortDetectorProvider flex={1}>
<ScrollView>
{Array.from({ length: 10 }).map((_, index) => (
<ViewComponent key={`app_item_${index}`} />
))}
</ScrollView>
</ViewPortDetectorProvider>
</SafeAreaView>
);
}
function ViewComponent(): JSX.Element {
const [inViewPort, setInViewPort] = useState(false);
return (
<ViewPortDetector
onChange={setInViewPort}
percentHeight={0.7}
frequency={300}
>
<View style={[styles.item, inViewPort ? styles.inViewPort : undefined]} />
</ViewPortDetector>
);
}
Properties | Description | Default |
---|---|---|
frequency |
The frequency (in milliseconds) to check if the child is in the viewport | 1000 |
percentWidth |
The minimum percentage of width required for the child to be considered in the viewport | 1 |
percentHeight |
The minimum percentage of height required for the child to be considered in the viewport | 1 |
API | Description | Required |
---|---|---|
onChange |
A callback function called when the visibility state changes | true |
License
GitHub
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK