react-outer-click

react-outer-click

React component and hook which detect mouse clicks outside of an element.

Usage

useOuterClick Hook (recommended)

useOuterClick(refs, handler);

Parameters

• refs a single ref or array of refs to not be handled the user has clicked
• handler callback function to be called when the user has clicked

Example

import { useOuterClick } from 'react-outer-click';

const Example = (props) => {
  const el = useRef(null);

  useOuterClick(el, (event) => {
    event.preventDefault();
    console.log('Clicked outside');
  });

  return <div ref={el}>Example</div>;
};

OuterClick Component

<OuterClick onOuterClick={}></OuterClick>

Props

• children elements that will not be handled when clicked
• onOuterClick callback function to be called when the user has clicked

Example

import { OuterClick } from 'react-outer-click';

const Example = (props) => {
  return (
    <OuterClick
      onOuterClick={() => {
        event.preventDefault();
        console.log('Clicked outside');
      }}
    >
      Example
    </OuterClick>
  );
};

:warning: Previous versions of react-outer-click allowed OuterClick to be imported as default export. This is no longer supported and has been removed.

:information_source: The OuterClick component will wrap your children with a <div> element, and any additional props will be passed down. You can change the element rendered with the as prop:

  ...
  <OuterClick as="span" onOuterClick={...}>
    Example
  </OuterClick>
  ...

Requirements

Requires a minimum of React version 16.8.0. If you're on an older version of React, then checkout v1.

Changelog

v3.8.0 - 2022-04-14

Changed

• Refactored ref forwarding in OuterClick component.
• Updated @babel/runtime dependency to v7.17.9.
• Updated prop-types dependency to v15.8.1.
• Updated tiny-invariant dependency to v1.2.0.
• Updated react peer-dependency to support v18.

Removed

• Removed use-composed-ref dependency.