React / 系统课时
项目需求与页面规划
项目需求与页面规划
综合项目最容易在“边写边想”中失控。本课用一个轻量任务管理页作为样例,先把用户流程、页面区域、组件边界和数据来源一次规划清楚,再用最小页面骨架验证这些决策是否能落地。
学习目标
- 从核心用户任务收敛第一版需求和验收条件
- 把页面区域拆成职责清晰、可独立变化的组件
- 明确本地状态、页面状态与服务端数据的来源和归属
从用户流程收敛最小需求
先定义用户要完成什么,再决定页面上放什么。对任务管理页,第一版只覆盖“查看任务、按状态筛选、新增任务、切换完成状态”四个动作;编辑、拖拽排序、权限和批量操作全部延后。这样可以防止组件和状态在需求尚未稳定时提前膨胀。
把需求写成可验收的句子更有效:打开页面能看到任务列表;切换筛选条件只显示对应任务;输入标题后可以新增任务;勾选任务后完成状态立即更新。每一句都应能在浏览器里直接验证,而不是停留在“支持任务管理”这种模糊描述。
把页面结构变成组件边界
页面可以先按变化原因拆分,而不是按视觉碎片拆分。筛选条件经常变化,适合独立为 TaskFilter;列表负责迭代数据,适合为 TaskList;单条任务负责状态切换,适合为 TaskItem;新增表单维护输入草稿,适合为 TaskForm。页面级组件只负责组合这些区域并持有共享状态。
下面的最小骨架可以直接放进 Vite 创建的 React TypeScript 项目的 src/App.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>
);
}预期结果
页面显示“任务管理”、三个筛选按钮、一个新增输入框和两条初始任务。新增任务后列表立即出现新条目;切换筛选按钮或勾选任务时,列表会按当前状态重新显示。这段代码还没有追求样式和接口请求,它的价值是验证“页面有哪些区域、哪些状态需要共享、用户流程是否闭合”。如果此时已经需要大量跨层传参,说明组件边界或状态归属仍需调整。
明确数据来源和状态归属
同一页面里的数据不应全部塞进一个 useState。输入框草稿只影响表单,留在 TaskForm 最合适;筛选条件会影响列表,可以提升到页面层;任务集合如果未来来自接口,应由数据请求层负责获取和更新,页面只消费结果。

一个实用判断是:状态应放在“所有需要它的组件的最近公共祖先”或专门的数据层,而不是为了方便就放到最顶层。只有需要刷新后保留、跨页面共享或来自后端的数据,才值得进一步进入路由、缓存或服务端状态方案。
用验收清单冻结第一版范围
进入实现前,至少确认四件事:核心流程是否能从进入页面走到完成操作;每个组件是否只有一个主要职责;每份状态是否有明确唯一的拥有者;每个数据字段是否能说明来源。只要其中一项答不清,就先修改规划,而不是继续堆代码。
项目规划的结果不是一张漂亮原型图,而是一组可以直接指导实现和验收的约束:用户做什么、页面展示什么、组件各管什么、数据从哪里来。把这四个问题在编码前说清楚,后续重构成本会明显降低。