EventIntermediateBrowser APIshooks/events/useDoubleClick.ts

useDoubleClick

Separate single vs double click.

Import

TypeScript
import { useDoubleClick } from '@/hooks';

API

Signature

useDoubleClick({ latency?, onSingleClick?, onDoubleClick? })

When to use

Use useDoubleClick instead of re-implementing the same pattern in multiple components.

SSR / Next.js

No-ops until document/window exist.

Live playground

Edit the example and see it run against the real @/hooks package in this app.

Live playgroundEdit · run with real @/hooks · useDoubleClick
Editor
function FileRow() {
  const onClick = useDoubleClick({
    onSingleClick: () => console.log('select'),
    onDoubleClick: () => console.log('open'),
    latency: 250,
  });
  return <div onClick={onClick}>report.pdf</div>;
}
Preview

Implementation source

Full library source for useDoubleClick — copy into your project when you are not installing a package yet.

hooks/events/useDoubleClick.ts
import { useCallback, useRef } from 'react';
import { useLatest } from '../utility/useLatest';

export interface UseDoubleClickOptions {
  latency?: number;
  onSingleClick?: (event: React.MouseEvent | React.TouchEvent) => void;
  onDoubleClick?: (event: React.MouseEvent | React.TouchEvent) => void;
}

/** Distinguishes single vs double click within a latency window. */
export function useDoubleClick(options: UseDoubleClickOptions = {}) {
  const { latency = 300, onSingleClick, onDoubleClick } = options;
  const clickCount = useRef(0);
  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);
  const singleRef = useLatest(onSingleClick);
  const doubleRef = useLatest(onDoubleClick);

  return useCallback(
    (event: React.MouseEvent | React.TouchEvent) => {
      clickCount.current += 1;
      if (timer.current) clearTimeout(timer.current);
      timer.current = setTimeout(() => {
        if (clickCount.current === 1) singleRef.current?.(event);
        else if (clickCount.current > 1) doubleRef.current?.(event);
        clickCount.current = 0;
      }, latency);
    },
    [latency, singleRef, doubleRef],
  );
}

Copy-paste example

useDoubleClick.example.tsx
'use client';

import { useDoubleClick } from '@/hooks';

export function FileRow() {
  const onClick = useDoubleClick({
    onSingleClick: () => console.log('select'),
    onDoubleClick: () => console.log('open'),
    latency: 250,
  });
  return <div onClick={onClick}>report.pdf</div>;
}

Production checklist

  • Called only from Client Components or other custom hooks
  • Type parameters filled in (e.g. useFetch<User[]>)
  • Tip: Pass all relevant refs to useClickOutside (trigger + panel). Prefer useLatest for handlers.
  • Source of truth: open hooks/events/useDoubleClick.ts for implementation details