React / 系统课时

设计组件与类型模型

设计组件与类型模型

组件拆分决定代码如何协作,类型模型决定数据如何流动。本课以任务管理页为例,完整建立业务组件边界,并把服务端实体、页面领域对象和表单数据分开建模,避免一个“大而全”的类型贯穿整个应用。

学习目标

  • 按职责和变化原因拆分业务组件,而不是按标签数量拆分
  • 区分接口 DTO、领域实体和表单值三类类型
  • 用 TypeScript 编译检查验证组件与数据边界是否一致

先按变化原因拆组件

组件边界应跟着业务职责走。页面容器负责协调筛选条件和任务数据;TaskFilter 只表达筛选意图;TaskForm 只管理新增任务所需的输入;TaskList 负责渲染集合;TaskItem 负责展示单个任务并上报状态切换事件。这样任何一个区域变化时,都不必理解整页实现。

不建议把每个 div、按钮或文本都拆成组件。一个组件只有在“有独立职责、会独立变化、需要复用或值得单独测试”时才有拆分价值。过度拆分会让数据在大量薄组件之间穿梭,反而增加阅读成本。

任务管理页的组件边界与类型流向

这张图里最重要的边界不是组件数量,而是数据何时被转换。接口返回值应在进入 UI 之前整理成稳定的领域对象,表单提交值也应在发请求前转换,而不是让每个子组件分别理解后端字段。

区分实体、表单和接口类型

同一个“任务”在不同阶段承担的职责不同,因此不应该共用一个接口。后端 DTO 可能使用蛇形字段和宽松字符串;领域实体需要更严格的联合类型和易用的 Date;表单值则通常保留适合输入控件的字符串。

下面是一个可独立放在 src/domain/task.ts 中的完整类型模块。它把外部数据和内部模型隔开,并在转换时拒绝未知状态。

ts
export type TaskStatus = "todo" | "doing" | "done";

export interface TaskDto {
  id: string;
  title: string;
  status: string;
  due_at: string | null;
}

export interface Task {
  id: string;
  title: string;
  status: TaskStatus;
  dueAt: Date | null;
}

export interface TaskFormValues {
  title: string;
  status: TaskStatus;
  dueDate: string;
}

export interface TaskListResponse {
  items: TaskDto[];
  total: number;
}

const taskStatuses: TaskStatus[] = ["todo", "doing", "done"];

export function toTask(dto: TaskDto): Task {
  if (!taskStatuses.includes(dto.status as TaskStatus)) {
    throw new Error(`Unknown task status: ${dto.status}`);
  }

  return {
    id: dto.id,
    title: dto.title.trim(),
    status: dto.status as TaskStatus,
    dueAt: dto.due_at ? new Date(dto.due_at) : null
  };
}

这里的 TaskDto 只描述服务端契约,Task 只服务于应用内部,TaskFormValues 只服务于表单。后端把 due_at 改名时,只需要调整 DTO 和映射函数,而不是修改所有展示组件。

让组件只接收真正需要的数据

类型边界还应体现在 props 上。TaskItem 需要的是一个 Task 和“切换状态”的回调,不需要整个接口响应、分页信息或表单状态;TaskFilter 只需要当前筛选值和变更事件。传得越精确,组件越容易复用和测试。

不要为了少写几个类型就把 TaskListResponse 一路传到列表项。这样会让 UI 组件依赖网络层结构,一旦接口增加分页包装、字段改名或返回格式调整,纯展示组件也会被迫跟着修改。

用编译检查验证模型边界

完成类型拆分后,在项目根目录执行 TypeScript 检查。该命令不会生成文件,只验证项目中的类型关系。

bash
npx tsc --noEmit

预期输出

text
(无标准输出,进程退出码为 0)

如果组件仍然直接读取 due_at、把任意字符串赋给 TaskStatus,或表单把 Date 当作输入框值使用,编译阶段就更容易暴露这些边界混用问题。实际项目的错误位置和行号会随代码变化。

设计组件和设计类型其实是在做同一件事:确定职责边界。组件只接收完成职责所需的数据,外部 DTO 在边界处转换,表单拥有独立输入模型,应用内部就能保持稳定而清晰的数据流。

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

目录与阅读设置

阅读设置

17

记录一个想法

设计组件与类型模型

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

登录哪都通