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 · useDoubleClickEditor
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.tsfor implementation details