Skip to content
This repository was archived by the owner on Sep 28, 2021. It is now read-only.

CloudlessMoon/react-native-stickyheader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

be92f69 · Jan 7, 2021

History

20 Commits
Jan 7, 2021
Jan 7, 2021
Jan 7, 2021
Jan 7, 2021
Jan 7, 2021
Jan 7, 2021
Jan 7, 2021
Jan 7, 2021

Repository files navigation

react-native-stickyheader

介绍

此组件实现类似React Native ScrollView组件的吸顶效果。 使用原生驱动动画,支持FlatList,SectionList,ListView等有onScroll方法的组件。

效果

iOS Android

Example

import React, { useState, useCallback, useRef, useEffect } from 'react';
import { StyleSheet, Text, View, FlatList, Animated } from 'react-native';

import StickyHeader from 'react-native-stickyheader';

function App() {
  const scrollY = useRef(new Animated.Value(0));
  const [data, setData] = useState([]);

  useEffect(() => {
    let array = [];
    for (let index = 0; index < 100; index++) {
      array.push(index);
    }
    setData(array);
  }, []);

  const renderItem = useCallback((info) => {
    return (
      <View style={{ height: 50, backgroundColor: '#ffffff' }}>
        <Text>{info.item}</Text>
      </View>
    );
  }, []);

  const keyExtractor = useCallback((item, index) => {
    return index + '';
  }, []);

  return (
    <View style={styles.container}>
      <View style={{ height: 64, backgroundColor: '#973444' }} />
      <Animated.ScrollView
        onScroll={Animated.event(
          [
            {
              nativeEvent: { contentOffset: { y: scrollY.current } },
            },
          ],
          { useNativeDriver: true },
        )}
        scrollEventThrottle={1}
      >
        <Text>文字</Text>
        <Text>文字</Text>
        <Text>文字</Text>
        <Text>文字</Text>
        <StickyHeader
          stickyHeaderY={60} // 滑动到多少悬浮
          stickyScrollY={scrollY.current}
        >
          <View style={{ height: 60, backgroundColor: '#d22222' }} />
        </StickyHeader>
        <FlatList
          data={data}
          keyExtractor={keyExtractor}
          renderItem={renderItem}
        />
      </Animated.ScrollView>
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    backgroundColor: '#ffffff',
    justifyContent: 'center',
  },
});

Note: scrollEventThrottle={1}此属性必须设置且为1,因为要保证有足够的偏移量回调。

react-native-stickyheader 的原理

待整理

Installation

$ npm install react-native-stickyheader --save

Usage (API)

此组件有以下属性:

Property Type Required Description
stickyHeaderY number NO 滑动到多少悬浮
stickyScrollY any Yes 动画的ScrollY回调

更新

1.1.0

  • 支持安卓

1.0.3

  • bug修改

1.0.0

  • 吸顶效果

1.1.2

  • 简化组件

1.1.3

  • react hook

Contributing

此组件受到ScrollView组件启发而成。如果觉得好用,请点一个star,有bug的话请提issue,我会尽快解决。

About

列表上悬浮的cell

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published