Skip to content

Movie 搜索 App

中等 约 35 分钟

你将构建什么

搜索 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. 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. 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. 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. 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. 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 等等。

查看术语表

解读错误信息

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

查看错误

← 返回主题