SCALE — Build Lab
開発パターン · JAVASCRIPT PATTERN

検索 Debounce(300ms)

CATEGORY開発パターン TYPEJavaScript Pattern EFFORT15〜30分 DIFFICULTY
PRIMARY CODE
ts
import { useEffect, useState } from 'react';

export function useDebouncedValue<T>(value: T, delay = 300): T {
  const [debounced, setDebounced] = useState(value);
  useEffect(() => {
    const t = setTimeout(() => setDebounced(value), delay);
    return () => clearTimeout(t);
  }, [value, delay]);
  return debounced;
}

// 使い方:
// const [q, setQ] = useState('');
// const debouncedQ = useDebouncedValue(q, 300);
// useEffect(() => { if (debouncedQ) search(debouncedQ); }, [debouncedQ]);
前提条件
Tailwind CSS v4TypeScript 5
USE CASES
  • 任意のダッシュボードに組み込み

検索 Debounce(300ms)

:LiTarget: 用途

検索入力を debounce して API 呼び出しを節約。リアルタイム検索の標準。

:LiSparkle: 特徴

  • 300msデバウンス
  • AbortController で中断
  • インクリメンタル検索

:LiCode: コード(コピペ用)

import { useEffect, useState } from 'react';

export function useDebouncedValue<T>(value: T, delay = 300): T {
  const [debounced, setDebounced] = useState(value);
  useEffect(() => {
    const t = setTimeout(() => setDebounced(value), delay);
    return () => clearTimeout(t);
  }, [value, delay]);
  return debounced;
}

// 使い方:
// const [q, setQ] = useState('');
// const debouncedQ = useDebouncedValue(q, 300);
// useEffect(() => { if (debouncedQ) search(debouncedQ); }, [debouncedQ]);

:LiHandPointer: 使い方

対象プロジェクトに該当ファイルをコピーして、props を流し込むだけ。

:LiAlertCircle: 注意事項

  • 依存パッケージを忘れず追加