This package exposes a <Modal /> component which is fully controlled by a single prop. It comes packed with enter and exit animations for all your motion needs.

It's currently powered by react-transition-group but I'm planning to turn it into a zero-dependency package in the near future so that it doesn't hurt your bundle size.

🔧 Installation

With NPM

npm install react-lean-modal

With Yarn

yarn add react-lean-modal

📦 Usage

Enough talk, show me the code.

<Modal
  enterAnimation="fade"
  exitAnimation="fade"
  timeout={250}
  isOpen={showModal}
  onClose={() => setShowModal(false)}
  titleElement={<h3>Example Modal</h3>}
/>

🔌 API

| Property | Description | Type | Default | | -------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ------------ | | isOpen | Whether the modal is open or closed | boolean | false | | onClose | Function that's called when a close action is registered. This is where we set the isOpen prop to false | () => void | - | | children | Content to render inside the modal's content area | React.ReactNode | - | | enterAnimation | The animation to show when modal opens | AnimationType | "zoom-in" | | exitAnimation | The animation to show when modal closes. Behaves as the reverse of enterAnimation. | AnimationType | "zoom-in" | | timeout | The duration of animations in milliseconds | number | 250(ms) | | titleElement | Content to render on the left of the modal header | React.ReactNode | - | | closeIcon | Content to render inside the close button | React.ReactNode | Included SVG | | classNames | Additional class names to apply to the modal | {root?: string, backdrop?: string, content?: string, header?: string, closeButton?: string, body?: string} | {} |

AnimationType

"fade" | "fade-left" | "fade-right" | "fade-top" | "fade-bottom" | "slide-left" | "slide-right" | "slide-top" | "slide-bottom" | "zoom-in" | "zoom-out" | "spin-cw" | "spin-ccw" | "rotate-left" | "rotate-right" | "rotate-top" | "rotate-bottom"

🚨 Forking this repo

Many people have contacted us asking if they can use this code for their own websites. The answer to that question is usually "yes", with attribution. There are some cases, such as using this code for a business or something that is greater than a personal project, that we may be less comfortable saying yes to. If in doubt, please don't hesitate to ask us.

We value keeping this package open source, but as you all know, plagiarism is bad. We actively spend a non-negligible amount of effort developing, designing, and trying to perfect this iteration of our package, and we are proud of it! All we ask is to not claim this effort as your own.

So, feel free to fork this repo. If you do, please just give us proper credit by linking back to this repo, https://github.com/SneakySensei/react-lean-modal. Refer to this handy quora post if you're not sure what to do. Thanks!

💥 Mention

Parts of this README is inspired from https://github.com/jagnani73/react-easy-marquee/.