Skip to content

A zero-dependency Swipeable FlatList for React-Native, with Gestures, Quick Actions, and Animations. Simple as that.

License

Notifications You must be signed in to change notification settings

esthor/react-native-swipeable-list

Folders and files

NameName
Last commit message
Last commit date

Latest commit

358fc56 Â· Aug 27, 2024
May 23, 2020
Nov 12, 2019
Aug 27, 2024
Oct 11, 2020
Nov 10, 2019
Aug 27, 2024
Mar 27, 2022
Nov 10, 2019
Jul 22, 2024
May 19, 2020
Jan 25, 2023
Jan 25, 2023

Repository files navigation

react-native-swipeable-list

npm version Downloads License PRs Build status

A zero-dependency, Swipeable FlatList for React-Native with Quick Actions, Gestures, and Animations.

animated screenshot of a swipeable flatlist email inbox mockup using react-native-swipeable-list

Usage

  1. Install the package in your project: npm install react-native-swipeable-list or yarn add react-native-swipeable-list

  2. Import the component into your component: import SwipeableFlatList from 'react-native-swipeable-list';

  3. Pass it a data array. It inherits FlatListProps from the standard FlatList component from react-native.

It can be passed additional props:

  • shouldBounceOnMount (default = true) - To alert the user that swiping is possible, the first row can bounce on component mount. Type boolean

  • maxSwipeDistance - Maximum distance to open to after a swipe. Type number || (Object => number)

  • renderQuickActions - Callback method to render the view that will be unveiled on swipe. Type renderItemType (which provides index and item, which will be very useful for performing actions on your items)

Example

Check out the example in the /examples folder. Clone this repo, then cd examples && yarn install && yarn start and then either react-native run-ios or react-native run-android to get the app up and running locally. Play with the code and see what you can do! 😎

History & Shoutouts

Started from the SwipeableFlatList component that was removed from react-native's experimental libraries. (See: https://github.com/facebook/react-native/commit/9ca7989f60cc8137705effeaad0f128fa73ed2e4)