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,并确保服务端接口与前述约定一致。

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>
  );
}

预期结果:

text
页面首次打开后请求 /api/tasks?page=1&pageSize=5。
创建任务后输入框清空,列表回到第 1 页并重新加载。
修改状态、负责人或详情后,服务端保存成功,列表显示最新数据。
筛选条件变化时页码重置为 1,分页按钮根据总条数启用或禁用。

动态任务 ID、接口域名和请求时间会因实际环境不同而变化。若前后端分离部署,应把 /api 替换为项目统一配置的 API 基地址。

处理关键边界

创建按钮需要阻止空标题提交,筛选条件变化时必须回到第一页,否则旧页码可能超出新结果范围。服务端返回错误时,不要清空当前列表,让用户仍能看到已有数据并重新操作。

示例中的负责人下拉选项为演示数据,真实项目应从用户接口加载,并按权限过滤可分配人员。分页应由服务端执行,不能先加载全部任务再由浏览器切片。

运行与验收

启动前端与后端后,依次创建两条任务,修改其中一条状态和负责人,再使用关键词与状态筛选。最后打开详情修改标题,确认刷新浏览器后结果仍然存在。

验收时重点检查:请求参数是否正确、总条数是否驱动页数、更新失败时是否出现明确提示,以及后端是否校验不存在的任务 ID。只有页面刷新后数据仍保持一致,才说明完整链路已打通。

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

目录与阅读设置

阅读设置

17

记录一个想法

实现任务管理功能

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

登录哪都通