Code Monkey home page Code Monkey logo

react-onclickout's Introduction

An ES6-friendly on-click-outside React component.

This is a React component that can be used to listen for clicks outside of a given component. As an example, you may need to hide a menu when a user clicks elsewhere on the page.

This component was created specifically to support ES6-style React components. If you want to use a mixin instead, I would recommend the react-onclickoutside mixin.

Installation

npm install react-onclickout --save

React Version Support

For React 0.14 or later, use version 2.x of this package. For React 0.13 or earlier, use version 1.x of this package.

Usage

There are two ways to use this component.

As a wrapper component

const ClickOutHandler = require('react-onclickout');

class ExampleComponent extends React.Component {

  onClickOut(e) {
    alert('user clicked outside of the component!');
  }

  render() {
    return (
      <ClickOutHandler onClickOut={this.onClickOut}>
        <div>Click outside of me!</div>
      </ClickOutHandler>
    );
  }
}

As a base component

const ClickOutComponent = require('react-onclickout');

class ExampleComponent extends ClickOutComponent {

  onClickOut(e) {
    alert('user clicked outside of the component!');
  }

  render() {
    return (
      <div>Click outside of me!</div>
    );
  }
}

Ignoring Elements

There are times when you may want to ignore certain elements that were clicked outside of the target component. You can handle such a scenario by inspecting the event passed to your onClickOut method handler.

const ClickOutHandler = require('react-onclickout');

class ExampleComponent extends React.Component {

  onClickOut(e) {
    if (hasClass(e.target, 'ignore-me')) return;
    alert('user clicked outside of the component!');
  }

  render() {
    return (
      <ClickOutHandler onClickOut={this.onClickOut}>
        <div>Click outside of me!</div>
      </ClickOutHandler>
    );
  }
}

That's pretty much it. Pull requests are more than welcome!

react-onclickout's People

Contributors

boblauer avatar grassick avatar modosc avatar razh avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

react-onclickout's Issues

If a click triggered the creation of the react-onclickout component, onClickOut immediately fires

If a click in the UI was what caused the clickout component to be rendered, it immediately fires.

Simple example:

class SelectExprComponent extends React.Component
  constructor: ->
    super
    @state = { active: false }

  handleActivate: =>
    @setState(active: true)

  handleDeactivate: =>
    @setState(active: false)

  render: ->
    if @state.active
      R ClickOutHandler, onClickOut: @handleDeactivate,
        H.input type: "text", initialValue: ""
    else
      H.a onClick: @handleActivate, "Select..."      

Will immediately flip back to inactive state because click that happened before ClickOutHandler was created is still propagating up to the window.

I have a pull request for this that I'll put up shortly.

Clicking another ClickOutHandler prevents onClickOut from firing

I was shopping for a component like this for use with ES6 classes, and discovered a bug when I read the source.

If you have this:

<ClickOutHandler onClickOut={this._handleRedClickOut}>
    <div className="red" />
</ClickOutHandler>
<ClickOutHandler onClickOut={this._handleGreenClickOut}>
    <div className="green" />
</ClickOutHandler>

And you click the .red element, the _handleGreenClickOut does not get called, and vice-versa.

This is because by the time the click event bubbles up to window, its __isClickIn is set to true if the click happened inside any ClickOutHandler: https://github.com/boblauer/react-onclickout/blob/master/src/index.jsx#L26

Here's a fiddle: http://jsfiddle.net/twq0d65y/3/

React 16 error

Hello,

I'm trying to upgrade React to v.16 and I'm running into errors with this package. Getting this error: Uncaught Error: Unable to find node on an unmounted component. at var el = ReactDOM.findDOMNode(this); in the componentDidMount method. Have you been able to use this package with React 16? I'm wondering if it's an issue with the new version of React or my setup.

Thanks.

Stop using react-id

In react 0.15, there is no react-id, so we need to stop relying on it to identify the clicked element.

Support for `passive` flag?

Hi, thanks a ton for this component.

I'm seeing perf warnings in my Chrome because of the non-passive event handler on touchmove. MDN says the passive flag is basically a promise from the developer to the browser to never call preventDefault in the handler.

How would you feel about a passive boolean property on the ClickOutside component that's passed down to addEventListener?

Ignore element

Hi,

Thank you for this cool component. It would be so nice if you can implement an option to ignore certain elements when clicking outside.

Regards.

React 18 not supporting depency

I try to upgrade my project react 16 to 18, I getting below error

npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR! 
npm ERR! While resolving: [email protected]
npm ERR! Found: [email protected]
npm ERR! node_modules/react
npm ERR!   react@"^18.2.0" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer react@"^15.x || ^16.x" from [email protected]
npm ERR! node_modules/react-onclickout
npm ERR!   react-onclickout@"*" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force, or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.

Deferred binding to window click causing strange testing effects

If a synchronous unit test is done that involves the component in any way, it will leave behind click events that will fire later. It's because the unmount is called before the deferred binding to the window.

The reason is that the binding to the window is deferred, but it should check that the component hasn't already unmounted before binding.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.