React / 系统课时
实现任务管理功能
实现任务管理功能
本课完成任务管理页的核心闭环:用户可以创建任务、修改状态和负责人,按条件筛选并分页浏览,还能进入详情编辑。最终页面会以服务端数据为准,所有操作都通过统一 API 层完成,便于后续接入缓存和乐观更新。
学习目标
- 设计覆盖创建、查询、更新和详情编辑的任务数据结构
- 使用 React 18 与 TypeScript 实现筛选、分页和表单交互
- 明确列表刷新、错误处理和验收标准
明确数据与接口
任务列表至少需要 id、标题、状态、负责人、截止日期和更新时间。筛选条件放在查询参数中,分页结果同时返回当前页数据与总条数,前端才能计算页数。
建议后端提供以下接口:POST /api/tasks 创建任务,GET /api/tasks 查询列表,GET /api/tasks/:id 查询详情,PATCH /api/tasks/:id 更新任务。状态值固定为 TODO、DOING、DONE,避免前后端使用不同文案作为业务值。

实现任务管理页
下面是主示例。它依赖 React 18,使用浏览器原生 fetch 调用后端,不依赖额外状态库。将文件保存为 TaskPage.tsx,并确保服务端接口与前述约定一致。
import { FormEvent, useCallback, useEffect, useState } from "react";
type TaskStatus = "TODO" | "DOING" | "DONE";
type Task = {
id: number;
title: string;
status: TaskStatus;
assignee: string | null;
dueDate: string | null;
};
type TaskPageResult = {
items: Task[];
total: number;
};
const pageSize = 5;
async function request<T>(url: string, init?: RequestInit): Promise<T> {
const response = await fetch(url, {
headers: { "Content-Type": "application/json" },
...init,
});
if (!response.ok) {
throw new Error(`请求失败:${response.status}`);
}
return response.json() as Promise<T>;
}
export default function TaskPage() {
const [tasks, setTasks] = useState<Task[]>([]);
const [total, setTotal] = useState(0);
const [keyword, setKeyword] = useState("");
const [status, setStatus] = useState<TaskStatus | "">("");
const [page, setPage] = useState(1);
const [title, setTitle] = useState("");
const [editing, setEditing] = useState<Task | null>(null);
const [error, setError] = useState("");
const loadTasks = useCallback(async () => {
const params = new URLSearchParams({
page: String(page),
pageSize: String(pageSize),
});
if (keyword.trim()) params.set("keyword", keyword.trim());
if (status) params.set("status", status);
try {
setError("");
const data = await request<TaskPageResult>(`/api/tasks?${params}`);
setTasks(data.items);
setTotal(data.total);
} catch (err) {
setError(err instanceof Error ? err.message : "加载失败");
}
}, [keyword, page, status]);
useEffect(() => {
void loadTasks();
}, [loadTasks]);
async function createTask(event: FormEvent) {
event.preventDefault();
if (!title.trim()) return;
await request<Task>("/api/tasks", {
method: "POST",
body: JSON.stringify({ title: title.trim() }),
});
setTitle("");
setPage(1);
// setPage 异步生效;当前已在第 1 页时主动刷新,否则交给 effect 加载
if (page === 1) await loadTasks();
}
async function updateTask(id: number, patch: Partial<Task>) {
await request<Task>(`/api/tasks/${id}`, {
method: "PATCH",
body: JSON.stringify(patch),
});
await loadTasks();
}
async function saveEditingTask() {
if (!editing) return;
await updateTask(editing.id, {
title: editing.title,
status: editing.status,
assignee: editing.assignee,
dueDate: editing.dueDate,
});
setEditing(null);
}
const pageCount = Math.max(1, Math.ceil(total / pageSize));
return (
<main>
<h2>任务管理</h2>
<form onSubmit={createTask}>
<input
value={title}
onChange={(event) => setTitle(event.target.value)}
placeholder="输入任务标题"
/>
<button type="submit">创建任务</button>
</form>
<section>
<input
value={keyword}
onChange={(event) => {
setKeyword(event.target.value);
setPage(1);
}}
placeholder="按标题筛选"
/>
<select
value={status}
onChange={(event) => {
setStatus(event.target.value as TaskStatus | "");
setPage(1);
}}
>
<option value="">全部状态</option>
<option value="TODO">待处理</option>
<option value="DOING">进行中</option>
<option value="DONE">已完成</option>
</select>
</section>
{error && <p role="alert">{error}</p>}
<ul>
{tasks.map((task) => (
<li key={task.id}>
<button type="button" onClick={() => setEditing(task)}>
{task.title}
</button>
<select
value={task.status}
onChange={(event) =>
void updateTask(task.id, {
status: event.target.value as TaskStatus,
})
}
>
<option value="TODO">待处理</option>
<option value="DOING">进行中</option>
<option value="DONE">已完成</option>
</select>
<select
value={task.assignee ?? ""}
onChange={(event) =>
void updateTask(task.id, {
assignee: event.target.value || null,
})
}
>
<option value="">未分配</option>
<option value="张三">张三</option>
<option value="李四">李四</option>
</select>
</li>
))}
</ul>
<nav aria-label="任务分页">
<button
type="button"
disabled={page === 1}
onClick={() => setPage((value) => value - 1)}
>
上一页
</button>
<span>{page} / {pageCount}</span>
<button
type="button"
disabled={page === pageCount}
onClick={() => setPage((value) => value + 1)}
>
下一页
</button>
</nav>
{editing && (
<section aria-label="编辑任务">
<input
value={editing.title}
onChange={(event) =>
setEditing({ ...editing, title: event.target.value })
}
/>
<select
value={editing.status}
onChange={(event) =>
setEditing({
...editing,
status: event.target.value as TaskStatus,
})
}
>
<option value="TODO">待处理</option>
<option value="DOING">进行中</option>
<option value="DONE">已完成</option>
</select>
<input
value={editing.assignee ?? ""}
onChange={(event) =>
setEditing({
...editing,
assignee: event.target.value || null,
})
}
placeholder="负责人"
/>
<input
type="date"
value={editing.dueDate ?? ""}
onChange={(event) =>
setEditing({
...editing,
dueDate: event.target.value || null,
})
}
/>
<button type="button" onClick={() => void saveEditingTask()}>
保存
</button>
<button type="button" onClick={() => setEditing(null)}>
取消
</button>
</section>
)}
</main>
);
}预期结果:
页面首次打开后请求 /api/tasks?page=1&pageSize=5。
创建任务后输入框清空,列表回到第 1 页并重新加载。
修改状态、负责人或详情后,服务端保存成功,列表显示最新数据。
筛选条件变化时页码重置为 1,分页按钮根据总条数启用或禁用。动态任务 ID、接口域名和请求时间会因实际环境不同而变化。若前后端分离部署,应把 /api 替换为项目统一配置的 API 基地址。
处理关键边界
创建按钮需要阻止空标题提交,筛选条件变化时必须回到第一页,否则旧页码可能超出新结果范围。服务端返回错误时,不要清空当前列表,让用户仍能看到已有数据并重新操作。
示例中的负责人下拉选项为演示数据,真实项目应从用户接口加载,并按权限过滤可分配人员。分页应由服务端执行,不能先加载全部任务再由浏览器切片。
运行与验收
启动前端与后端后,依次创建两条任务,修改其中一条状态和负责人,再使用关键词与状态筛选。最后打开详情修改标题,确认刷新浏览器后结果仍然存在。
验收时重点检查:请求参数是否正确、总条数是否驱动页数、更新失败时是否出现明确提示,以及后端是否校验不存在的任务 ID。只有页面刷新后数据仍保持一致,才说明完整链路已打通。