1.0.2 • Published 12 months ago

bottom-sheet-react-native v1.0.2

Weekly downloads
-
License
MIT
Repository
github
Last release
12 months ago

Here's an updated version of the README to reflect the changes made to the BottomSheet component:


Bottom Sheet React Native

A customizable, animated bottom sheet component for React Native applications.

Installation

npm install bottom-sheet-react-native

or if you're using yarn:

yarn add bottom-sheet-react-native

Dependencies

This package requires the following peer dependencies:

  • react
  • react-native
  • react-native-reanimated
  • twrnc

Make sure these are installed in your project.

Usage

Here's a basic example of how to use the BottomSheet component:

import React, { useRef } from "react";
import { View, Button } from "react-native";
import { BottomSheet, BottomSheetMethods } from "bottom-sheet-react-native";

const App = () => {
  const bottomSheetRef = useRef < BottomSheetMethods > null;

  const openBottomSheet = () => {
    bottomSheetRef.current?.open();
  };

  const handleOutsideClick = () => {
    // Custom logic when clicking outside the bottom sheet
    console.log("Outside area clicked!");
    bottomSheetRef.current?.close();
  };

  return (
    <View style={{ flex: 1 }}>
      <Button title="Open Bottom Sheet" onPress={openBottomSheet} />
      <BottomSheet ref={bottomSheetRef} onClickOutside={handleOutsideClick}>
        <View style={{ padding: 20 }}>
          {/* Your bottom sheet content goes here */}
          <Button
            title="Close"
            onPress={() => bottomSheetRef.current?.close()}
          />
        </View>
      </BottomSheet>
    </View>
  );
};

export default App;

Props

The BottomSheet component accepts the following props:

PropTypeRequiredDefaultDescription
childrenReact.ReactNodeYes-The content to be displayed inside the bottom sheet.
minHeightnumber | stringNo"30%"The minimum height of the bottom sheet. Can be a number (interpreted as pixels) or a string (e.g., '50%').
onClickOutside() => voidNo-A callback function triggered when clicking outside the bottom sheet.

Methods

The BottomSheet component exposes the following methods through a ref:

MethodDescription
open()Opens the bottom sheet.
close()Closes the bottom sheet.

To use these methods, create a ref and pass it to the BottomSheet component:

const bottomSheetRef = useRef < BottomSheetMethods > null;

// Later in your code:
bottomSheetRef.current?.open();
// or
bottomSheetRef.current?.close();

Styling

The BottomSheet uses twrnc for styling. You can customize the appearance by modifying the Tailwind classes in the component.

Animations

This component uses react-native-reanimated for smooth animations. The bottom sheet slides up from the bottom of the screen when opened and slides down when closed.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License.


This update reflects the new onClickOutside prop and how users can handle outside clicks with custom logic.

1.0.2

12 months ago

1.0.1

1 year ago

1.0.0

1 year ago