React / 系统课时

项目需求与页面规划

项目需求与页面规划

综合项目最容易在“边写边想”中失控。本课用一个轻量任务管理页作为样例,先把用户流程、页面区域、组件边界和数据来源一次规划清楚,再用最小页面骨架验证这些决策是否能落地。

学习目标

  • 从核心用户任务收敛第一版需求和验收条件
  • 把页面区域拆成职责清晰、可独立变化的组件
  • 明确本地状态、页面状态与服务端数据的来源和归属

从用户流程收敛最小需求

先定义用户要完成什么,再决定页面上放什么。对任务管理页,第一版只覆盖“查看任务、按状态筛选、新增任务、切换完成状态”四个动作;编辑、拖拽排序、权限和批量操作全部延后。这样可以防止组件和状态在需求尚未稳定时提前膨胀。

把需求写成可验收的句子更有效:打开页面能看到任务列表;切换筛选条件只显示对应任务;输入标题后可以新增任务;勾选任务后完成状态立即更新。每一句都应能在浏览器里直接验证,而不是停留在“支持任务管理”这种模糊描述。

把页面结构变成组件边界

页面可以先按变化原因拆分,而不是按视觉碎片拆分。筛选条件经常变化,适合独立为 TaskFilter;列表负责迭代数据,适合为 TaskList;单条任务负责状态切换,适合为 TaskItem;新增表单维护输入草稿,适合为 TaskForm。页面级组件只负责组合这些区域并持有共享状态。

下面的最小骨架可以直接放进 Vite 创建的 React TypeScript 项目的 src/App.tsx,用于验证页面规划是否可落地。

tsx
import { type FormEvent, useMemo, useState } from "react";

type Filter = "all" | "open" | "done";
type Task = { id: number; title: string; done: boolean };

export default function App() {
  const [filter, setFilter] = useState<Filter>("all");
  const [title, setTitle] = useState("");
  const [tasks, setTasks] = useState<Task[]>([
    { id: 1, title: "梳理页面结构", done: true },
    { id: 2, title: "实现任务列表", done: false }
  ]);

  const visibleTasks = useMemo(() => {
    if (filter === "open") return tasks.filter((task) => !task.done);
    if (filter === "done") return tasks.filter((task) => task.done);
    return tasks;
  }, [filter, tasks]);

  function addTask(event: FormEvent<HTMLFormElement>) {
    event.preventDefault();
    const value = title.trim();
    if (!value) return;
    setTasks((current) => [...current, { id: Date.now(), title: value, done: false }]);
    setTitle("");
  }

  return (
    <main>
      <h1>任务管理</h1>
      <nav>
        <button onClick={() => setFilter("all")}>全部</button>
        <button onClick={() => setFilter("open")}>未完成</button>
        <button onClick={() => setFilter("done")}>已完成</button>
      </nav>

      <form onSubmit={addTask}>
        <input value={title} onChange={(event) => setTitle(event.target.value)} />
        <button type="submit">新增</button>
      </form>

      <ul>
        {visibleTasks.map((task) => (
          <li key={task.id}>
            <label>
              <input
                type="checkbox"
                checked={task.done}
                onChange={() =>
                  setTasks((current) =>
                    current.map((item) =>
                      item.id === task.id ? { ...item, done: !item.done } : item
                    )
                  )
                }
              />
              {task.title}
            </label>
          </li>
        ))}
      </ul>
    </main>
  );
}

预期结果

text
页面显示“任务管理”、三个筛选按钮、一个新增输入框和两条初始任务。新增任务后列表立即出现新条目;切换筛选按钮或勾选任务时,列表会按当前状态重新显示。

这段代码还没有追求样式和接口请求,它的价值是验证“页面有哪些区域、哪些状态需要共享、用户流程是否闭合”。如果此时已经需要大量跨层传参,说明组件边界或状态归属仍需调整。

明确数据来源和状态归属

同一页面里的数据不应全部塞进一个 useState。输入框草稿只影响表单,留在 TaskForm 最合适;筛选条件会影响列表,可以提升到页面层;任务集合如果未来来自接口,应由数据请求层负责获取和更新,页面只消费结果。

任务管理页的用户流程、页面区域与数据来源

一个实用判断是:状态应放在“所有需要它的组件的最近公共祖先”或专门的数据层,而不是为了方便就放到最顶层。只有需要刷新后保留、跨页面共享或来自后端的数据,才值得进一步进入路由、缓存或服务端状态方案。

用验收清单冻结第一版范围

进入实现前,至少确认四件事:核心流程是否能从进入页面走到完成操作;每个组件是否只有一个主要职责;每份状态是否有明确唯一的拥有者;每个数据字段是否能说明来源。只要其中一项答不清,就先修改规划,而不是继续堆代码。

项目规划的结果不是一张漂亮原型图,而是一组可以直接指导实现和验收的约束:用户做什么、页面展示什么、组件各管什么、数据从哪里来。把这四个问题在编码前说清楚,后续重构成本会明显降低。

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

目录与阅读设置

阅读设置

17

记录一个想法

项目需求与页面规划

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

登录哪都通