@sandstreamdev/react-swipeable-list

<h1 align="center">react-swipeable-list</h1> <h4 align="center">Swipeable list component for React.</h4> <img src="docs/example.gif"></img> <a href="#demo">Demo</a> • <a href="#installation">Installation</a> • <a href="#usage">Usage</a> • <a href="#contributors-">Contributors</a> <hr /> [![Actions Status](https://github.com/sandstreamdev/react-swipeable-list/workflows/Node%20CI/badge.svg)](https://github.com/sandstreamdev/react-swipeable-list/actions) [![codecov](https://codecov.io/gh/sandstreamdev/react-swipeable-list/branch/master/graph/badge.svg)](https://codecov.io/gh/sandstreamdev/react-swipeable-list) ![GitHub Release Date](https://img.shields.io/github/release-date/sandstreamdev/react-swipeable-list) [![All Contributors](https://img.shields.io/badge/all_contributors-15-orange.svg?style=flat-square)](#contributors-) ## React Swipeable List component A control to render list with swipeable items. Items can have action on left and right swipe. Swipe action triggering can be configured. ## Demo Check [working example page](https://sandstreamdev.github.io/react-swipeable-list/) or experiment on: [![Edit react-swipeable-list](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/github/sandstreamdev/react-swipeable-list/tree/master/examples) ## Installation ```bash npm install @sandstreamdev/react-swipeable-list # or via yarn yarn add @sandstreamdev/react-swipeable-list ``` ## Usage ```jsx import { SwipeableList, SwipeableListItem } from '@sandstreamdev/react-swipeable-list'; import '@sandstreamdev/react-swipeable-list/dist/styles.css'; <SwipeableList> <SwipeableListItem swipeLeft={{ content: <div>Revealed content during swipe</div>, action: () => console.info('swipe action triggered') }} swipeRight={{ content: <div>Revealed content during swipe</div>, action: () => console.info('swipe action triggered') }} onSwipeProgress={progress => console.info(`Swipe progress: ${progress}%`)} > <div>Item name</div> </SwipeableListItem> </SwipeableList> ``` or use function as children pattern if other container is needed (check animation and styled container examples). Note that in this case you need to provide list wrapper and pass default `className` props to have same behaviour. Default `SwipeableList` styles are passed in `className` prop. ```jsx <SwipeableList> {({ className, ...rest }) => ( <div className={className}> <SwipeableListItem swipeLeft={{ content: <div>Revealed content during swipe</div>, action: () => console.info('swipe action triggered') }} swipeRight={{ content: <div>Revealed content during swipe</div>, action: () => console.info('swipe action triggered') }} {...rest} > <div>Item name</div> </SwipeableListItem> </div> )} </SwipeableList> ``` ## SwipeableList Props ### scrollStartThreshold Type: `number` (optional, default: `10`) How far in pixels scroll needs to be done to block swiping. After scrolling is started and goes beyond the threshold, swiping is blocked. It can be set for the whole list or for every item. See `scrollStartThreshold` for `SwipeableListItem`. Value from the `SwipeableListItem` takes precedence. ### swipeStartThreshold Type: `number` (optional, default: `10`) How far in pixels swipe needs to be done to start swiping on list item. After a swipe is started and goes beyond the threshold, scrolling is blocked. It can be set for the whole list or for every item. See `swipeStartThreshold` for `SwipeableListItem`. Value from the `SwipeableListItem` takes precedence. ### threshold Type: `number` (optional, default: `0.5`) How far swipe needs to be done to trigger attached action. `0.5` means that item needs to be swiped to half of its width, `0.25` - one-quarter of width. It can be set for the whole list or for every item. See `threshold` for `SwipeableListItem`. Value from the `SwipeableListItem` takes precedence. ## SwipeableListItem Props ### blockSwipe Type: `boolean` (optional, default: `false`) If set to `true` all defined swipe actions are blocked. #### children Type: `Anything that can be rendered` (required) Content that is visible by default and swipeable to reveal the left and right views. ### swipeLeft Type: `Object` (optional) Data for defining left swipe action and rendering content after item is swiped. The object requires following structure: ```js { action, // required: swipe action (function) actionAnimation, // optional: type of animation content, // required: HTML or React component } ``` #### action Type: `function` (required) Callback function that should be run when swipe is done beyond threshold. #### actionAnimation Type: `ActionAnimations (RETURN | REMOVE | NONE)` (optional, default: `RETURN`) Animation type to be played swipe is done beyond threshold. #### content Type: `Anything that can be rendered` (required) Content that is revealed when swiping. ### swipeRight Type: `Object` Same as `swipeLeft` but to right. :wink: ### scrollStartThreshold Type: `number` (default: `10`) How far in pixels scroll needs to be done to block swiping. After scrolling is started and goes beyond the threshold, swiping is blocked. It can be set for the whole list or for every item. See `scrollStartThreshold` for `SwipeableList`. Value from the `SwipeableListItem` takes precedence. ### swipeStartThreshold Type: `number` (default: `10`) How far in pixels swipe needs to be done to start swiping on list item. After a swipe is started and goes beyond the threshold, scrolling is blocked. It can be set for the whole list or for every item. See `swipeStartThreshold` for `SwipeableList`. Value from the `SwipeableListItem` takes precedence. ### threshold Type: `number` (default: `0.5`) How far swipe needs to be done to trigger attached action. `0.5` means that item needs to be swiped to half of its width, `0.25` - one-quarter of width. It can be set for the whole list or for every item. See `threshold` for `SwipeableList`. Value from the `SwipeableListItem` takes precedence. ### onSwipeStart Type: `() => void` Fired after swipe has started (after drag gesture passes the `swipeStartThreshold` distance in pixels). ### onSwipeEnd Type: `() => void` Fired after swipe has ended. ### onSwipeProgress Type: `(progress: number) => void` Fired every time swipe progress changes. The reported `progress` value is always an integer in range 0 to 100 inclusive. ## Contributors ✨ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):    <table> <tr> <td align="center"><a href="https://github.com/sandstreamdevelopment"><img src="https://avatars2.githubusercontent.com/u/44231396?v=4?s=100" width="100px;" alt=""/> sandstreamdevelopment</a> <a href="#business-sandstreamdevelopment" title="Business development">💼</a> <a href="#financial-sandstreamdevelopment" title="Financial">💵</a> <a href="#ideas-sandstreamdevelopment" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="https://github.com/marekrozmus"><img src="https://avatars3.githubusercontent.com/u/26272040?v=4?s=100" width="100px;" alt=""/> Marek Rozmus</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/commits?author=marekrozmus" title="Code">💻</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/commits?author=marekrozmus" title="Documentation">📖</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/commits?author=marekrozmus" title="Tests">⚠️</a> <a href="#example-marekrozmus" title="Examples">💡</a> <a href="#ideas-marekrozmus" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="https://github.com/jakubbogacz"><img src="https://avatars3.githubusercontent.com/u/26272028?v=4?s=100" width="100px;" alt=""/> jakubbogacz</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/pulls?q=is%3Apr+reviewed-by%3Ajakubbogacz" title="Reviewed Pull Requests">👀</a> <a href="#ideas-jakubbogacz" title="Ideas, Planning, & Feedback">🤔</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/commits?author=jakubbogacz" title="Documentation">📖</a></td> <td align="center"><a href="https://github.com/LukasMarx"><img src="https://avatars0.githubusercontent.com/u/8080408?v=4?s=100" width="100px;" alt=""/> Lukas Marx</a> <a href="#ideas-LukasMarx" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="https://www.linkedin.com/in/luis-filipe42/"><img src="https://avatars1.githubusercontent.com/u/29440533?v=4?s=100" width="100px;" alt=""/> Luis Filipe Pedroso</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/issues?q=author%3ALuisFilipePedroso" title="Bug reports">🐛</a></td> <td align="center"><a href="https://github.com/przemyslawzalewski"><img src="https://avatars0.githubusercontent.com/u/30114244?v=4?s=100" width="100px;" alt=""/> Przemysław Zalewski</a> <a href="#maintenance-przemyslawzalewski" title="Maintenance">🚧</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/pulls?q=is%3Apr+reviewed-by%3Aprzemyslawzalewski" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/commits?author=przemyslawzalewski" title="Code">💻</a> <a href="#ideas-przemyslawzalewski" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="https://marktension.github.io/tension_design/"><img src="https://avatars0.githubusercontent.com/u/16321685?v=4?s=100" width="100px;" alt=""/> MarkTension</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/issues?q=author%3AMarkTension" title="Bug reports">🐛</a></td> </tr> <tr> <td align="center"><a href="https://github.com/wildeyes"><img src="https://avatars3.githubusercontent.com/u/1652108?v=4?s=100" width="100px;" alt=""/> wildeyes</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/issues?q=author%3Awildeyes" title="Bug reports">🐛</a></td> <td align="center"><a href="http://www.deruli.de"><img src="https://avatars0.githubusercontent.com/u/1799239?v=4?s=100" width="100px;" alt=""/> Der Uli im Netz</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/issues?q=author%3AderUli" title="Bug reports">🐛</a> <a href="#ideas-derUli" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="https://github.com/Iliyaz1995"><img src="https://avatars0.githubusercontent.com/u/31325754?v=4?s=100" width="100px;" alt=""/> Iliyaz syed</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/issues?q=author%3AIliyaz1995" title="Bug reports">🐛</a></td> <td align="center"><a href="https://twitter.com/jamescuenod"><img src="https://avatars2.githubusercontent.com/u/4253884?v=4?s=100" width="100px;" alt=""/> James Cuénod</a> <a href="#ideas-jcuenod" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="https://github.com/akshar07"><img src="https://avatars2.githubusercontent.com/u/11475137?v=4?s=100" width="100px;" alt=""/> Akshar Takle</a> <a href="#ideas-akshar07" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="http://mohammedfaragallah.herokuapp.com"><img src="https://avatars0.githubusercontent.com/u/14910456?v=4?s=100" width="100px;" alt=""/> Mohammed Faragallah</a> <a href="#ideas-MohammedFaragallah" title="Ideas, Planning, & Feedback">🤔</a></td> <td align="center"><a href="https://davidreact.github.io/portfolio/"><img src="https://avatars3.githubusercontent.com/u/17351751?v=4?s=100" width="100px;" alt=""/> David</a> <a href="#ideas-davidreact" title="Ideas, Planning, & Feedback">🤔</a></td> </tr> <tr> <td align="center"><a href="https://github.com/ziabskiK"><img src="https://avatars0.githubusercontent.com/u/33325556?v=4?s=100" width="100px;" alt=""/> Karol Ziąbski</a> <a href="https://github.com/sandstreamdev/react-swipeable-list/issues?q=author%3AziabskiK" title="Bug reports">🐛</a></td> <td align="center"><a href="http://bluestembrands.com"><img src="https://avatars.githubusercontent.com/u/142194?v=4?s=100" width="100px;" alt=""/> Matt Ruby</a> <a href="#maintenance-mattruby" title="Maintenance">🚧</a></td> </tr> </table>    This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!