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/.