自定义 Hooks 集合
你将构建什么
三个自定义 hooks:useLocalStorage(持久化状态)、useDebounce(防抖值)和 useFetch(含 loading/error 状态的数据获取)。
学习目标
- 将有状态逻辑提取为自定义 hook
- 在自定义 hook 中使用 useState 和 useEffect
- 从 hook 返回值和函数
- 在其它 hook 中组合 hook
前置要求
- React 函数组件
- useState 和 useEffect hooks
- JavaScript 闭包
步骤
- 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
构建 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
构建 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
组合 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
测试 hooks
编写使用三个 hooks 的简单测试组件,验证:localStorage 持久化、防抖延迟、fetch 加载数据。用 React DevTools 检查状态。
提示
对 useFetch 的 cancelled 标志,尝试在 fetch 期间卸载组件——不应出现警告。
自己动手试试
import { useState, useEffect } from 'react';
function useLocalStorage(key, initialValue) {
// TODO: useState + useEffect to sync with localStorage
}function useLocalStorage(k, v) { const [s, set] = useState(() => JSON.parse(localStorage.getItem(k) || 'null') ?? v); useEffect(() => localStorage.setItem(k, JSON.stringify(s)), [k, s]); return [s, set]; }你学到了什么
你构建了可复用自定义 hooks——React 在组件间共享有状态逻辑的方式,无需 render props 或 HOC。Hooks 自然组合。
相关资源
相关课程
- React Hooks
自定义 hooks 基于 useState 和 useEffect。
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。