Movie 搜索 App
你将构建什么
搜索 box 哪里用户类型 movie title. As 它们类型 (debounced), app 获取 matching movies 从 API and displays 它们 as cards 使用 title and year.
学习目标
- Implement debounced 搜索输入
- 获取搜索 results 从 API
- 渲染 results as cards 使用映射
- Handle 加载 and 空状态
前置要求
- useEffect and useState
- 获取 API
- 列表渲染
步骤
- 1
设置搜索状态 and debounce
创建状态 for 搜索查询, results, and 加载. Use debounce timer in useEffect 到 delay API call 直到用户停止输入.
代码const [query, setQuery] = useState(""); const [results, setResults] = useState([]); const [loading, setLoading] = useState(false); useEffect(() => { if (!query) { setResults([]); return; } const timer = setTimeout(async () => { setLoading(true); const res = await fetch(`https://www.omdbapi.com/?s=${query}&apikey=YOUR_KEY`); const data = await res.json(); setResults(data.Search || []); setLoading(false); }, 500); return () => clearTimeout(timer); }, [query]);预期结果
输入触发 debounced 搜索之后 500ms 的 inactivity.
- 2
渲染搜索输入 and results
Show 搜索输入边界到 查询状态, and 映射 over results 到 display movie cards.
代码<input value={query} onChange={e => setQuery(e.target.value)} placeholder="Search movies..." /> {loading && <p>Searching...</p>} {results.map(movie => ( <div key={movie.imdbID}> <h3>{movie.Title}</h3> <p>{movie.Year}</p> </div> ))}预期结果
Movie results appear as cards 使用 title and year.
- 3
添加状态管理与事件处理
使用 useState 管理组件状态,为交互元素添加 onClick/onChange 事件处理。状态是 React 组件的核心,事件处理让组件响应用户操作。
代码import { useState } from "react"; export function MyComponent() { const [count, setCount] = useState(0); const [text, setText] = useState(""); return ( <div> <button onClick={() => setCount(c => c + 1)}> Count: {count} </button> <input value={text} onChange={(e) => setText(e.target.value)} /> </div> ); }预期结果
点击按钮计数递增;输入框内容随键入实时更新。
- 4
添加 Props 验证与组件拆分
为组件定义 Props 接口(TypeScript)或 propTypes,将大组件拆分为更小的子组件。类型安全的 Props 让组件接口清晰、可复用。
代码interface ChildProps { label: string; value: number; onChange: (v: number) => void; } function Child({ label, value, onChange }: ChildProps) { return ( <label> {label} <input type="number" value={value} onChange={(e) => onChange(Number(e.target.value))} /> </label> ); }预期结果
子组件接收类型安全的 Props;父组件可复用子组件渲染多个字段。
- 5
测试组件渲染
使用 React Testing Library 渲染组件并断言输出,验证交互后状态正确更新。组件测试确保 UI 行为符合预期。
代码import { render, screen, fireEvent } from "@testing-library/react"; test("button increments count", () => { render(<MyComponent />); const btn = screen.getByText(/Count:/); fireEvent.click(btn); expect(screen.getByText("Count: 1")).toBeInTheDocument(); });预期结果
测试通过:点击后按钮文本变为 'Count: 1'。
自己动手试试
你学到了什么
你学习 debounced API calls 使用 useEffect and setTimeout cleanup, 常见模式 for 搜索输入. 这个 prevents excessive API 请求虽然用户是 still 输入.
相关资源
查阅不认识的术语
新手友好的术语表用大白话解释编程术语——变量、函数、DOM、Promise 等等。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。