react-click-boundary
v0.2.2
Published
Catch outside clicks with a React component
Downloads
9
Maintainers
Readme
This is a React component that helps you listen for clicks outside your element. Classic use cases for such a component are
- closing a dropdown when clicking outside
- closing a modal when clicking outside
- canceling inline editing when clicking outside
How is this better than the alternatives?
It has a better name 😃 Most of the alternative names are using verbs (
react-click-outside
orreact-onclickoutside
). I think that the component names should be using nouns and that's why this is calledreact-click-boundary
.It's not a Higher Order Component. The alternatives which are build as HOCs allow you to handle the events but only outside of your component. You wrap your component in their HOC and only the parent component can register a handler.
It doesn't add new DOM elements. Some of the alternatives add a
<div>
wrapper around your elements. This component doesn't do that, instead it uses your outermost element as a boundary.
In short: it has a better name, it's not a HOC and it doesn't add unnecesary DOM elements.
Installation
npm install react-click-boundary --save
Example
import React from 'react'
import ClickBoundary from 'react-click-boundary'
class Modal extends React.Component {
render() {
return (
<ClickBoundary onClickOutside={() => alert('yes!')}>
<div className="modal">
Content
</div>
</ClickBoundary>
)
}
}
export default Modal
Change Log
0.1.0 (2017-12-04) — initial release
Contributing
Before you submit a pull request, please take the following actions.
- Open an issue describing the contribution you would like to make
- Discuss until we all agree that your idea is useful for the project
- Create a pull request but make sure you follow the style guide and the tests pass
- Voila! You've done an amazing job.
Credits
- Hexbridge for sponsoring my open-source work.
License
MIT @ Andrei Canta