React.js useOnClickOutside Hook

React hook which listens for clicks outside of a specified element.

React.js useOnClickOutside Hook

import { useEffect } from 'react';

type Handler = (event: MouseEvent | TouchEvent) => void;

export const useOnClickOutside = (
  ref: React.RefObject<HTMLElement>,
  handler: Handler
) => {
  useEffect(
    () => {
      const listener = (event: TouchEvent | MouseEvent) => {
        // Do nothing if clicking ref's element or descendent elements
        if (!ref.current || ref.current.contains(event.target as Node)) {
          return;
        }
        handler(event);
      };
      document.addEventListener('mousedown', listener);
      document.addEventListener('touchstart', listener);
      return () => {
        document.removeEventListener('mousedown', listener);
        document.removeEventListener('touchstart', listener);
      };
    },
    // Add ref and handler to effect dependencies
    // It's worth noting that because the passed-in handler is a new ...
    // ... function on every render that will cause this effect ...
    // ... callback/cleanup to run every render. It's not a big deal ...
    // ... but to optimize you can wrap handler in useCallback before ...
    // ... passing it into this hook.
    [ref, handler]
  );
};

Usage

import React, { useRef, useState } from "react";

const Example: React.FC<ExampleProps> = ({}) => {
  const [isDropownOpen, setIsDropownOpen] = useState(false);
  const dropDownElementRef = useRef<HTMLDivElement>(null);

  useOnClickOutside(dropDownElementRef, () => setIsPopoverOpen(false)); 

  return (
    <div ref={dropDownElementRef}>
       {/* Dropdown component ... */}
    </div>
  )
};