JSPM

  • Created
  • Published
  • Downloads 17438
  • Score
    100M100P100Q221963F
  • License Apache-2.0

React native swiper flatlist component

Package Exports

  • react-native-swiper-flatlist

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (react-native-swiper-flatlist) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

👆 Swiper FlatList component

platforms npm npm travis license

Demo

Installation

yarn add react-native-swiper-flatlist

or

npm install react-native-swiper-flatlist --save

Notice

Version 2.x was re-implemented using React Hooks so it only works with version 0.59 or above

react-native-swiper-flatlist react-native
1.x <= 0.58
2.x >= 0.59

Example

Expo

Example

Code

import React, { PureComponent } from 'react';
import { Text, Dimensions, Image, StyleSheet, View } from 'react-native';

import SwiperFlatList from 'react-native-swiper-flatlist';

export default class App extends PureComponent {
  render() {
    return (
      <View style={styles.container}>
        <SwiperFlatList autoplay autoplayDelay={2} autoplayLoop index={2} showPagination>
          <View style={[styles.child, { backgroundColor: 'tomato' }]}>
            <Text style={styles.text}>1</Text>
          </View>
          <View style={[styles.child, { backgroundColor: 'thistle' }]}>
            <Text style={styles.text}>2</Text>
          </View>
          <View style={[styles.child, { backgroundColor: 'skyblue' }]}>
            <Text style={styles.text}>3</Text>
          </View>
          <View style={[styles.child, { backgroundColor: 'teal' }]}>
            <Text style={styles.text}>4</Text>
          </View>
        </SwiperFlatList>
      </View>
    );
  }
}

export const { width, height } = Dimensions.get('window');

const styles = StyleSheet.create({
  container: {
    flex: 1,
    backgroundColor: 'white',
  },
  child: {
    height: height * 0.5,
    width,
    justifyContent: 'center',
  },
  text: {
    fontSize: width * 0.5,
    textAlign: 'center',
  },
});

Code example

Props

Prop Default Type Description
data not required if children is used array Data to use in renderItem
children - node Children elements
renderItem not required if children is used func Takes an item from data and renders it into the list
onMomentumScrollEnd - func Called after scroll end and the first parameter is the current index
vertical false bool Show vertical swiper
index 0 number Index to start
renderAll false bool Render all the items before display it
Pagination
showPagination false bool Show pagination
paginationDefaultColor gray string Pagination color
paginationActiveColor white string Pagination color
paginationStyle {} ViewPropTypes.style Style object for container
paginationStyleItem {} ViewPropTypes.style Style object for item (dot)
onPaginationSelectedIndex - func Executed when the user presses the pagination index, similar properties onChangeIndex
PaginationComponent Component node Overwrite Pagination component
Autoplay
autoplay false bool Change index automatically
autoplayDelay 3 number Delay between every page in seconds
autoplayLoop false bool Continue playing after reach end
autoplayLoopKeepAnimation false bool Show animation when reach the end of the list
autoplayInvertDirection false bool Invert auto play direction
disableGesture false bool Disable swipe gesture

More props

This is a wrapper around Flatlist, all their props works well and the inherited props too (from ScrollView and VirtualizedList)

Functions

Name Params Use
scrollToIndex { index: number, animated: bool?} Scroll to the index
getCurrentIndex - Returns the current index
getPrevIndex - Returns the previous index
onChangeIndex { index: number, prevIndex: number} Executed every time the index change, the index change when the user reaches 60% of the next screen
goToFirstIndex - Go to the first index
goToLastIndex - Go to the last index

Limitations

  • Vertical pagination is not supported on Android. Doc
  • react-native-web is not supported, due to the lack of support of some props used in this library. Expo example

Author

Gustavo Gard