React / 系统课时

实现数据列表与筛选

实现数据列表与筛选

本节完成一个可直接运行的数据列表页:组件先从本地 HTTP 资源请求数据,再处理加载与失败状态,最后把搜索、分类筛选和分页串成一条稳定的数据派生链路。

学习目标

  • 使用 fetch 与 useEffect 完成列表数据请求和状态处理
  • 用搜索词与分类条件派生可见数据,而不是重复保存结果状态
  • 在筛选条件变化时正确重置分页并验证边界情况

先把数据流拆清楚

列表页同时存在“服务端返回的原始数据”和“用户当前看到的数据”。原始数据请求成功后保持不变;搜索、分类与分页只是基于原始数组逐层派生。这样可以避免筛选结果、分页结果和原始数组之间互相覆盖。

列表请求筛选与分页数据流

为了让示例不依赖第三方接口,在 Vite 项目的 public/products.json 放入固定测试数据。浏览器访问 /products.json 时会通过开发服务器发起真实 HTTP 请求。

json
[
  {"id":1,"name":"机械键盘","category":"外设","price":499},
  {"id":2,"name":"无线鼠标","category":"外设","price":199},
  {"id":3,"name":"27 寸显示器","category":"显示","price":1699},
  {"id":4,"name":"便携显示器","category":"显示","price":1299},
  {"id":5,"name":"USB-C 扩展坞","category":"配件","price":399},
  {"id":6,"name":"笔记本支架","category":"配件","price":159}
]

这份数据文件生效后,可直接在浏览器打开 /products.json 验证服务器是否能返回数组。

完成请求、筛选与分页

把下面代码保存为 src/main.jsx。示例使用每页 2 条数据,便于立即观察筛选后页数变化;AbortController 会在组件卸载时取消未完成请求。

jsx
import { StrictMode, useEffect, useMemo, useState } from "react";
import { createRoot } from "react-dom/client";

const PAGE_SIZE = 2;

function ProductList() {
  const [products, setProducts] = useState([]);
  const [status, setStatus] = useState("loading");
  const [query, setQuery] = useState("");
  const [category, setCategory] = useState("全部");
  const [page, setPage] = useState(1);

  useEffect(() => {
    const controller = new AbortController();

    async function loadProducts() {
      try {
        const response = await fetch("/products.json", {
          signal: controller.signal,
        });
        if (!response.ok) throw new Error(`HTTP ${response.status}`);
        setProducts(await response.json());
        setStatus("success");
      } catch (error) {
        if (error.name !== "AbortError") setStatus("error");
      }
    }

    loadProducts();
    return () => controller.abort();
  }, []);

  const categories = useMemo(
    () => ["全部", ...new Set(products.map((item) => item.category))],
    [products]
  );

  const filtered = useMemo(() => {
    const keyword = query.trim().toLowerCase();
    return products.filter((item) => {
      const matchesQuery = item.name.toLowerCase().includes(keyword);
      const matchesCategory =
        category === "全部" || item.category === category;
      return matchesQuery && matchesCategory;
    });
  }, [products, query, category]);

  const pageCount = Math.max(1, Math.ceil(filtered.length / PAGE_SIZE));
  const visible = filtered.slice((page - 1) * PAGE_SIZE, page * PAGE_SIZE);

  function updateQuery(value) {
    setQuery(value);
    setPage(1);
  }

  function updateCategory(value) {
    setCategory(value);
    setPage(1);
  }

  if (status === "loading") return <p>正在加载...</p>;
  if (status === "error") return <p>加载失败,请检查数据文件。</p>;

  return (
    <main style={{ maxWidth: 720, margin: "40px auto", fontFamily: "sans-serif" }}>
      <h1>商品列表</h1>
      <input
        value={query}
        onChange={(event) => updateQuery(event.target.value)}
        placeholder="搜索商品"
      />
      <select
        value={category}
        onChange={(event) => updateCategory(event.target.value)}
        style={{ marginLeft: 8 }}
      >
        {categories.map((item) => (
          <option key={item} value={item}>{item}</option>
        ))}
      </select>

      <ul>
        {visible.map((item) => (
          <li key={item.id}>
            {item.name} · {item.category} · ¥{item.price}
          </li>
        ))}
      </ul>

      {filtered.length === 0 && <p>没有匹配结果。</p>}

      <button disabled={page === 1} onClick={() => setPage((p) => p - 1)}>
        上一页
      </button>
      <span style={{ margin: "0 12px" }}>{page} / {pageCount}</span>
      <button
        disabled={page === pageCount}
        onClick={() => setPage((p) => p + 1)}
      >
        下一页
      </button>
    </main>
  );
}

createRoot(document.getElementById("root")).render(
  <StrictMode>
    <ProductList />
  </StrictMode>
);

预期结果

text
初始状态:共 6 条商品,每页显示 2 条,页码为 1 / 3
搜索“显示器”:显示 2 条结果,页码重置为 1 / 1
选择“配件”:显示 2 条配件商品
搜索不存在的关键字:显示“没有匹配结果。”

为什么不把筛选结果再存一份 state

filtered 和 visible 都能由 products、query、category、page 计算得到,因此不需要再用 useState 保存。否则一次筛选动作可能要同步修改多份状态,任何一步遗漏都会产生“条件已经变了,但列表还是旧数据”的问题。

useMemo 在这里表达的是“派生数据”。对于只有几条记录的小列表,它不是性能必需品;真正重要的是数据只保留一个事实来源。数据量扩大后,再根据测量结果决定是否需要服务端搜索、服务端分页或缓存。

验证请求失败与分页边界

启动开发服务器后再测试页面:

bash
npm run dev

预期输出

text
Local: http://localhost:<PORT>/

实际端口可能不同。正常加载后,依次检查搜索、分类、上一页和下一页;再临时把请求地址改成 /missing.json,页面应进入“加载失败”状态,而不是无限停留在加载中。

这个列表的关键不是控件数量,而是状态关系:请求结果是源数据,搜索与分类是过滤条件,分页只作用于过滤后的结果。保持这条顺序,后续把本地 JSON 换成真实 API 时,交互逻辑仍然容易维护。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现数据列表与筛选

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通