react-native-swipe-item

React Native Swipe Item

A swipe item for react-native. Support both iOS and Android.

Example

See react-native-swipe-item-demo.

Installation

npm i --save react-native-swipe-item

Usage

You can use the SwipeButtonsContainer to wrap buttons that you want to show when users swipe the item, and pass it to props.

import { SwipeItem, SwipeButtonsContainer } from 'react-native-swipe-item';

export default function SwipeButtonCustom() {

    const leftButton = (
        <SwipeButtonsContainer
            style={{
                alignSelf: 'center',
                aspectRatio: 1,
                flexDirection: 'column',
                padding: 10,
            }}
            
        >
            <TouchableOpacity
                onPress={() => console.log('left button clicked')}
            >
                <Text>Click me !</Text>
            </TouchableOpacity>
        </SwipeButtonsContainer>
    );
  
    return (
        <SwipeItem
            style={styles.button}
            swipeContainerStyle={styles.swipeContentContainerStyle}
            leftButtons={leftButton}
        >
            <Text>
                Swipe me!
            </Text>
        </SwipeItem>
    );
}

const styles = StyleSheet.create({
    button: {
        width: '80%',
        height: 100,
        alignSelf: 'center',
        marginVertical: 5,
    },
    swipeContentContainerStyle: {
        justifyContent: 'center',
        alignItems: 'center',
        backgroundColor: '#ffffff',
        borderRadius: 10,
        borderColor: '#e3e3e3',
        borderWidth: 1,
    }
});

SwipeItem Props

• style

• swipeContainerStyle

• leftButtons

• rightButtons

• containerView

• disableSwipeIfNoButton

• onSwipeInitial

• onLeftButtonsShowed

• onRightButtonsShowed

• onMovedToOrigin

style

These styles will be applied to the swipe item layout.

TYPE	REQUIRED
style	No

---

swipeContainerStyle

These styles will be applied to the swipe item container which user swipe.

Example:

return (
        <SwipeItem swipeContainerStyle={styles.swipeContentContainerStyle} >
        </SwipeItem>
    );
}

const styles = StyleSheet.create({
    swipeContentContainerStyle: {
        justifyContent: 'center',
        alignItems: 'center',
        backgroundColor: '#ffffff',
        borderRadius: 10,
        borderColor: '#e3e3e3',
        borderWidth: 1,
    }
});

TYPE	REQUIRED
style	No

---

leftButtons

Buttons that want to show on the left when the item swiped to right.

TYPE	REQUIRED
SwipeButtonsContainer	No

---

rightButtons

Buttons that want to show on the right when the item swiped to left.

TYPE	REQUIRED
SwipeButtonsContainer	No

---

containerView

The component for the swipe item.

• Before RN 0.57.0, the child view would be clipped by parent view when the child view layout out of the parent. Recommend to use ViewOverflow plugin to solve this problem.

Example:

import ViewOverflow from 'react-native-view-overflow';
...
...
export default function SwipeButtonCustom() {  
    return (
        <SwipeItem
            style={styles.button}
            swipeContainerStyle={styles.swipeContentContainerStyle}
            containerView={ViewOverflow}
        >
            <Text>
                Swipe me!
            </Text>
        </SwipeItem>
    );
}
...

TYPE	REQUIRED	PLATFORM
ViewOverflow	Yes	Android

---

onSwipeInitial

This prop will be called when the item started swipe from the origin position, and the SwipeItem reference passed as an argument.

---

onLeftButtonsShowed

This prop will be called when left buttons showed, and the SwipeItem reference passed as an argument.

---

onRightButtonsShowed

This prop will be called when right buttons showed, and the SwipeItem reference passed as an argument.

---

onMovedToOrigin

This prop will be called when the item moved to the origin, and the SwipeItem reference passed as an argument.

---

disableSwipeIfNoButton

since v0.4

Disable the swipe feature when there are no buttons.

TYPE	REQUIRED
boolean	No

---

SwipeItem Methods

• close

close

Close the swipe item.

---

License

MIT