react-native-modal-2 v1.0.6

React Native Modal 2

A powerful, customizable modal library for React Native with smooth animations, touchable backdrop, and comprehensive TypeScript support.

Features

• 🎨 Fully customizable UI with flexible styling options
• 🔄 Multiple animation types (fade, slide, bounce, zoom)
• 🧭 Directional animations (up, down, left, right)
• 🎯 Touchable backdrop to close modal
• 📱 Works seamlessly on both iOS and Android
• 🔧 Comprehensive TypeScript support
• 🪝 Includes useModal hook for easy state management
• ⚡ Optimized performance with native driver animations
• 🧩 Simple API with sensible defaults
• 🔍 Zero default styling for content - complete freedom to design your modal
• 🔌 Full prop drilling support for the underlying React Native Modal

Installation

# npm
npm install react-native-modal-2

# yarn
yarn add react-native-modal-2

# pnpm
pnpm add react-native-modal-2

Quick Start

Basic Modal

import React from "react";
import { View, Text, Button, StyleSheet } from "react-native";
import { Modal, useModal } from "react-native-modal-2";

const App = () => {
  const { visible, showModal, hideModal } = useModal();

  return (
    <View style={styles.container}>
      <Button title="Show Basic Modal" onPress={showModal} />

      <Modal visible={visible} onBackdropPress={hideModal} animationType="fade">
        <View style={styles.modalContent}>
          <Text style={styles.title}>Hello!</Text>
          <Text style={styles.description}>
            This is a basic modal with a fade animation.
          </Text>
          <Button title="Close" onPress={hideModal} />
        </View>
      </Modal>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: "center",
    alignItems: "center",
    padding: 20,
  },
  modalContent: {
    backgroundColor: "white",
    padding: 20,
    borderRadius: 10,
    maxWidth: "80%",
    shadowColor: "#000",
    shadowOffset: {
      width: 0,
      height: 2,
    },
    shadowOpacity: 0.25,
    shadowRadius: 3.84,
    elevation: 5,
  },
  title: {
    fontSize: 18,
    fontWeight: "bold",
    marginBottom: 10,
  },
  description: {
    marginBottom: 20,
  },
});

export default App;

Animated Modal with Advanced Animations

import React, { useState } from "react";
import { View, Text, Button, StyleSheet } from "react-native";
import { AnimatedModal } from "react-native-modal-2";

const App = () => {
  const [slideModalVisible, setSlideModalVisible] = useState(false);
  const [bounceModalVisible, setBounceModalVisible] = useState(false);
  const [zoomModalVisible, setZoomModalVisible] = useState(false);

  return (
    <View style={styles.container}>
      <Button
        title="Slide Up Modal"
        onPress={() => setSlideModalVisible(true)}
        style={styles.button}
      />

      <Button
        title="Bounce Modal"
        onPress={() => setBounceModalVisible(true)}
        style={styles.button}
      />

      <Button
        title="Zoom Modal"
        onPress={() => setZoomModalVisible(true)}
        style={styles.button}
      />

      {/* Slide Modal */}
      <AnimatedModal
        visible={slideModalVisible}
        onBackdropPress={() => setSlideModalVisible(false)}
        animationIn="slide"
        animationDirection="up"
        backdropOpacity={0.7}
        contentContainerStyle={styles.modalContent}
      >
        <Text style={styles.title}>Slide Up Modal</Text>
        <Text style={styles.description}>
          This modal slides up from the bottom of the screen.
        </Text>
        <Button title="Close" onPress={() => setSlideModalVisible(false)} />
      </AnimatedModal>

      {/* Bounce Modal */}
      <AnimatedModal
        visible={bounceModalVisible}
        onBackdropPress={() => setBounceModalVisible(false)}
        animationIn="bounce"
        animationDirection="down"
        backdropColor="#2c3e50"
        contentContainerStyle={styles.modalContent}
      >
        <Text style={styles.title}>Bounce Modal</Text>
        <Text style={styles.description}>
          This modal bounces in from the top with a custom backdrop color.
        </Text>
        <Button title="Close" onPress={() => setBounceModalVisible(false)} />
      </AnimatedModal>

      {/* Zoom Modal */}
      <AnimatedModal
        visible={zoomModalVisible}
        onBackdropPress={() => setZoomModalVisible(false)}
        animationIn="zoom"
        animationOut="zoom"
        animationDuration={400}
        contentContainerStyle={styles.modalContent}
      >
        <Text style={styles.title}>Zoom Modal</Text>
        <Text style={styles.description}>
          This modal zooms in and out with a custom animation duration.
        </Text>
        <Button title="Close" onPress={() => setZoomModalVisible(false)} />
      </AnimatedModal>
    </View>
  );
};

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: "center",
    alignItems: "center",
    padding: 20,
  },
  button: {
    marginVertical: 10,
  },
  modalContent: {
    backgroundColor: "white",
    padding: 20,
    borderRadius: 10,
    maxWidth: "80%",
    shadowColor: "#000",
    shadowOffset: {
      width: 0,
      height: 2,
    },
    shadowOpacity: 0.25,
    shadowRadius: 3.84,
    elevation: 5,
  },
  title: {
    fontSize: 18,
    fontWeight: "bold",
    marginBottom: 10,
  },
  description: {
    marginBottom: 20,
  },
});

export default App;

API Reference

Modal Component

The Modal component provides a simple modal with basic animation options.

Props

AnimatedModal Component

The AnimatedModal component extends the basic Modal with more advanced animation options.

Props

Includes all props from the Modal component, plus:

useModal Hook

A convenient hook for managing modal visibility state.

const { visible, showModal, hideModal, toggleModal } = useModal(initialState);

Parameters

Return Values

Animation Types

Fade

The modal fades in and out with a smooth opacity transition.

Slide

The modal slides in from the specified direction (up, down, left, right).

Bounce

The modal bounces in from the specified direction with a spring-like effect.

Zoom

The modal zooms in and out with a scaling effect.

Customization Examples

Modal Content Styling

The library doesn't apply any default styling to your modal content, giving you complete freedom to design it however you want. You need to provide your own styling through the contentContainerStyle prop:

<AnimatedModal
  visible={visible}
  onBackdropPress={hideModal}
  animationIn="slide"
  contentContainerStyle={{
    backgroundColor: "#f8f9fa",
    borderRadius: 15,
    padding: 20,
    width: "90%",
    shadowColor: "#000",
    shadowOffset: { width: 0, height: 10 },
    shadowOpacity: 0.3,
    shadowRadius: 20,
    elevation: 10,
  }}
  backdropColor="#2c3e50"
  backdropOpacity={0.8}
>
  {/* Modal content */}
</AnimatedModal>

Custom Animation Duration

<AnimatedModal
  visible={visible}
  onBackdropPress={hideModal}
  animationIn="bounce"
  animationDuration={500} // Slower animation (500ms)
  contentContainerStyle={styles.modalContent}
>
  {/* Modal content */}
</AnimatedModal>

Using React Native Modal Props

You can pass any props from React Native's Modal component directly to our Modal components:

<Modal
  visible={visible}
  onBackdropPress={hideModal}
  animationType="fade"
  contentContainerStyle={styles.modalContent}
  style={styles.modalWrapper} // Style for the modal container
  hardwareAccelerated={true} // React Native Modal prop
  supportedOrientations={["portrait", "landscape"]} // React Native Modal prop
  onShow={() => console.log("Modal shown")} // React Native Modal prop
>
  {/* Modal content */}
</Modal>

Roadmap

We're constantly working to improve react-native-modal-2. Here are some features we plan to add in future releases:

Upcoming Features

• Separate Animation Durations: Different durations for entrance (animationInDuration) and exit (animationOutDuration) animations
• Backdrop Control: hasBackdrop prop to completely disable the backdrop when needed
• Custom Backdrop Component: Support for custom backdrop components beyond just color and opacity
• Lifecycle Events: onModalShow and onModalHide callbacks for better control of modal lifecycle
• Gesture Support: Swipe to dismiss and other gesture-based interactions
• Stacked Modals: Better support for displaying multiple modals simultaneously
• Enhanced Keyboard Handling: Improved KeyboardAvoidingView integration with automatic content adjustment when keyboard appears

Have a feature request? Feel free to open an issue or submit a pull request!

Troubleshooting

Animations Not Working

If animations aren't working correctly:

1. Make sure you're using a unique modal instance for each animation type
2. Verify that you're not rapidly toggling the modal visibility
3. Check that you're using the correct animation type and direction

Modal Content Not Displaying Correctly

If your modal content isn't displaying correctly:

1. Make sure you've provided proper styling through contentContainerStyle
2. Remember that the library doesn't apply any default styling to your content
3. Use ScrollView for content that might be too large

Performance Issues

If you're experiencing performance issues:

1. Use useNativeDriver: true for animations (this is enabled by default)
2. Avoid complex layouts inside the modal
3. Reduce the number of simultaneous animations

Contributing

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

License

MIT

Author

WrathChaos