Skip to content

自定义 Hooks 集合

中等 约 40 分钟

你将构建什么

三个自定义 hooks:useLocalStorage(持久化状态)、useDebounce(防抖值)和 useFetch(含 loading/error 状态的数据获取)。

学习目标

  • 将有状态逻辑提取为自定义 hook
  • 在自定义 hook 中使用 useState 和 useEffect
  • 从 hook 返回值和函数
  • 在其它 hook 中组合 hook

前置要求

  • React 函数组件
  • useState 和 useEffect hooks
  • JavaScript 闭包

步骤

  1. 1

    构建 useLocalStorage

    自定义 hook 就是以 'use' 开头并调用其它 hook 的函数。构建 useLocalStorage,类似 useState 但持久化到 localStorage。

    代码
    import { useState, useEffect } from 'react';
    
    function useLocalStorage(key, initialValue) {
      const [value, setValue] = useState(() => {
        const stored = localStorage.getItem(key);
        return stored ? JSON.parse(stored) : initialValue;
      });
      
      useEffect(() => {
        localStorage.setItem(key, JSON.stringify(value));
      }, [key, value]);
      
      return [value, setValue];
    }
    
    // Usage:
    function App() {
      const [name, setName] = useLocalStorage('name', 'Guest');
      return <input value={name} onChange={e => setName(e.target.value)} />;
    }

    预期结果

    输入值通过 localStorage 在页面重载后保持。

  2. 2

    构建 useDebounce

    创建一个返回值防抖版本的 hook——仅在用户停止输入延迟后更新。对搜索输入有用。

    代码
    function useDebounce(value, delay = 300) {
      const [debounced, setDebounced] = useState(value);
      
      useEffect(() => {
        const timer = setTimeout(() => setDebounced(value), delay);
        return () => clearTimeout(timer);  // cleanup on each change
      }, [value, delay]);
      
      return debounced;
    }
    
    // Usage in a search component:
    function Search() {
      const [query, setQuery] = useState('');
      const debouncedQuery = useDebounce(query, 500);
      
      useEffect(() => {
        if (debouncedQuery) console.log('Searching for:', debouncedQuery);
      }, [debouncedQuery]);
      
      return <input value={query} onChange={e => setQuery(e.target.value)} />;
    }

    预期结果

    快速输入 'abc' 仅在 500ms 无活动后触发一次搜索。

  3. 3

    构建 useFetch

    创建从 URL 获取数据并返回 { data, loading, error } 的 hook。处理清理以避免卸载后设置状态。

    代码
    function useFetch(url) {
      const [data, setData] = useState(null);
      const [loading, setLoading] = useState(true);
      const [error, setError] = useState(null);
      
      useEffect(() => {
        let cancelled = false;
        setLoading(true);
        fetch(url)
          .then(res => res.json())
          .then(data => { if (!cancelled) { setData(data); setLoading(false); } })
          .catch(err => { if (!cancelled) { setError(err); setLoading(false); } });
        return () => { cancelled = true; };
      }, [url]);
      
      return { data, loading, error };
    }

    预期结果

    初始返回 loading=true,fetch 完成后返回 data 或 error。

  4. 4

    组合 hooks

    将 useDebounce 与 useFetch 组合,创建仅在用户停止输入后获取结果的防抖搜索。这展示了 hook 组合。

    代码
    function SearchResults() {
      const [query, setQuery] = useState('');
      const debounced = useDebounce(query, 500);
      const { data, loading } = useFetch(
        debounced ? `/api/search?q=${debounced}` : null
      );
      
      return (
        <div>
          <input value={query} onChange={e => setQuery(e.target.value)} />
          {loading && <p>Loading...</p>}
          {data && <ul>{data.map(item => <li key={item.id}>{item.name}</li>)}</ul>}
        </div>
      );
    }

    预期结果

    搜索 fetch 仅在 500ms 无活动后触发,而非每次按键。

  5. 5

    测试 hooks

    编写使用三个 hooks 的简单测试组件,验证:localStorage 持久化、防抖延迟、fetch 加载数据。用 React DevTools 检查状态。

自己动手试试

你学到了什么

你构建了可复用自定义 hooks——React 在组件间共享有状态逻辑的方式,无需 render props 或 HOC。Hooks 自然组合。

相关资源

相关课程

  • React Hooks

    自定义 hooks 基于 useState 和 useEffect。

查阅不认识的术语

新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。

查看术语表

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回主题