fork-rn-bottom-sheet v0.2.0

git clone https://github.com/ammarahm-ed/react-native-actions-sheet.git

  

then run yarn or npm install in the example folder and finally to run the example app:

react-native run-android

npm install react-native-actions-sheet --save

or if you use yarn:

yarn add react-native-actions-sheet

import ActionSheet from 'react-native-actions-sheet';

const App = () => {
  let actionSheet;

  return (
    <View
      style={{
        justifyContent: 'center',
        flex: 1,
      }}>
      <TouchableOpacity
        onPress={() => {
          actionSheet.setModalVisible();
        }}>
        <Text>Open ActionSheet</Text>
      </TouchableOpacity>

      <ActionSheet ref={ref => (actionSheet = ref)}>
        <View>
          <Text>YOUR CUSTOM COMPONENT INSIDE THE ACTIONSHEET</Text>
        </View>
      </ActionSheet>
    </View>
  );
};

export default App;

Props

ref

Assigns a ref to ActionSheet component to use methods.

initialOffsetFromBottom

Use if you want to show the ActionSheet Partially on Opening. Requires gestureEnabled=true

Default:1

extraScroll

Normally when the ActionSheet is fully opened, a small portion from the bottom is hidden by default. Use this prop if you want the ActionSheet to hover over the bottom of screen and not hide a little behind it.

Default:0

containerStyle

Any custom styles for the container.

CustomHeaderComponent

Your custom header component. Using this will hide the default indicator.

headerAlwaysVisible

Keep the header always visible even when gestures are disabled.

Default: false

CustomFooterComponent

A footer component if you want to add some info at the bottom.

Note: Remember to give footer a fixed height and provide ActionSheet the footerHeight prop with same value. If you have added margins etc, add those values to footerHeight also.

footerHeight

Height of the footer

Default: 80

footerStyle

Custom Styles for the footer container.

footerAlwaysVisible

Keep footer visible. Currently when you overdraw, the footer appears, however you can change this by setting this to true.

Default: false

animated

Keep footer visible. Currently when you overdraw, the footer appears, however you can change this by setting this to true.

Default: true

openAnimationSpeed

Speed of opening animation. Higher means the ActionSheet will open more quickly.

Default: 12

closeAnimationDuration

Duration of closing animation.

Default: 300

gestureEnabled

Enables gesture control of ActionSheet

Default: false

closeOnTouchBackdrop

Control closing ActionSheet by touching on backdrop.

Default: true

bounceOnOpen

Bounces the ActionSheet on open.

Default: false

bounciness

How much you want the ActionSheet to bounce when it is opened.

Default: 8

springOffset

When touch ends and user has not moved farther from the set springOffset, the ActionSheet will return to previous position.

Default: 50

elevation

Add elevation to the ActionSheet container.

Default: 0

indicatorColor

Color of the gestureEnabled Indicator.

Default: "#f0f0f0"

overlayColor

Color of the overlay/backdrop.

Default: "black"

defaultOverlayOpacity

Default opacity of the overlay/backdrop.

Default: 0.3

closeOnPressBack

Will the ActionSheet close on hardwareBackPress event.

Default: true

onClose

Event called when the ActionSheet closes.

onOpen

An event called when the ActionSheet Opens.

Methods

Methods require you to set a ref on ActionSheet Component.

setModalVisible

ActionSheet can be opened or closed using its ref.

// First create a ref on your <ActionSheet/> Component.

<ActionSheet
ref={ref => this.actionSheet = ref}
/>

// then later in your function to open the ActionSheet:

this.actionSheet.setModalVisible();

Event Listeners

Listen to changes in ActionSheet State.

addHasReachedTopListener

Attach a listener to know when ActionSheet is fully opened and has reached top. Use this if you want to use a ScrollView inside the ActionSheet. Check the example for demonstration on how to use nested ScrollViews inside ActionSheet.

import ActionSheet, {addHasReachedTopListener, removeHasReachedTopListener} from 'react-native-actions-sheet


// In your Component

  const _onHasReachedTop = () => {
    // handle the event
  }

  useEffect(() => {
    addHasReachedTopListener(_onHasReachedTop)
    return () => {
        removeHasReachedTopListener(_onHasReachedTop)
    }
  },[])

Find this library useful? ❤️

Support it by joining stargazers for this repository. ⭐️ and follow me for my next creations!

MIT Licensed