Skip to content

Latest commit

 

History

History
129 lines (90 loc) · 5.17 KB

react-native-intersection-observer.md

File metadata and controls

129 lines (90 loc) · 5.17 KB

模板版本：v0.2.2

react-native-intersection-observer

Supported platforms License

[!TIP] Github 地址

安装与使用

请到三方库的 Releases 发布地址查看配套的版本信息：@react-native-oh-tpl/react-native-intersection-observer Releases 。对于未发布到npm的旧版本，请参考安装指南安装tgz包。

进入到工程目录并输入以下命令：

npm

npm install @react-native-oh-tpl/react-native-intersection-observer

yarn

yarn add @react-native-oh-tpl/react-native-intersection-observer

下面的代码展示了这个库的基本使用场景：

[!WARNING] 使用时 import 的库名不变。

import React, { useRef } from "react";
import { Text } from "react-native";
import {
  IOScrollView,
  IOScrollViewController,
  InView,
} from "react-native-intersection-observer";

function App() {
  const scrollViewRef = useRef<IOScrollViewController>(null);
  return (
    <IOScrollView ref={scrollViewRef}>
      <Text
        onPress={() => {
          scrollViewRef.current?.scrollToEnd();
        }}
      >
        Scroll to bottom
      </Text>
      <InView onChange={(inView: boolean) => console.log("Inview:", inView)}>
        <Text>
          Plain children are always rendered. Use onChange to monitor state.
        </Text>
      </InView>
    </IOScrollView>
  );
}

export default App;

约束与限制

兼容性

在下述版本验证通过：

  1. RNOH：0.72.20; SDK：HarmonyOS NEXT Developer Preview2; IDE：DevEco Studio 5.0.3.200; ROM：205.0.0.18;
  2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71;

属性

[!TIP] "Platform"列表示该属性在原三方库上支持的平台。

[!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。

详情请查看react-native-intersection-observer

IOScrollView 组件

Props: Inherits ScrollView Props

Name Description Type Required HarmonyOS Support
rootMargin root margin { top: number; left: number; right: number; bottom: number } false yes

Methods: Inherits ScrollView Methods

IOFlatList 组件

Props: Inherits FlatList Props

Name Description Type Required HarmonyOS Support
rootMargin root margin { top: number; left: number; right: number; bottom: number } false yes

Methods: Inherits FlatList Methods

InView 组件

Name Description Type Required HarmonyOS Support
as Render the wrapping element as this element. Defaults to View. ComponentType false yes
children Children expects a plain child, to have the <InView /> deal with the wrapping element. ReactNode true yes
triggerOnce Only trigger this method once. boolean false yes
onChange Call this function whenever the in view state changes. It will receive the inView boolean, alongside the current IntersectionObserverEntry. (inView: boolean) => void false yes

遗留问题

其他

开源协议

本项目基于 MIT License ，请自由地享受和参与开源。