React / 系统课时

定义 Props 类型

定义 Props 类型

Props 是父组件传给子组件的只读输入。使用 TypeScript 定义 Props 类型,可以在编码阶段发现缺失字段、错误类型和拼写问题,让组件的使用方式像函数参数一样清晰。

学习目标

  • 能够使用 type 定义组件 Props
  • 理解 Props 类型如何约束组件调用
  • 能够读取并渲染已声明的属性

Props 是组件的输入契约

函数组件可以接收一个对象参数,其中每个字段都由调用方在 JSX 中提供。TypeScript 类型描述了哪些字段必须存在,以及每个字段允许使用什么值。

Props 应描述组件真正需要的信息,而不是把整个业务对象无条件传入。输入越明确,组件越容易复用和测试。

定义并使用类型

下面定义一个 CourseCardProps 类型,再让 CourseCard 的参数遵循该类型。将代码放入 src/App.tsx 即可运行。

tsx
type CourseCardProps = {
  title: string;
  lessons: number;
  published: boolean;
};

function CourseCard({
  title,
  lessons,
  published,
}: CourseCardProps) {
  return (
    <article>
      <h2>{title}</h2>
      <p>共 {lessons} 课时</p>
      <p>{published ? "已发布" : "草稿"}</p>
    </article>
  );
}

export default function App() {
  return (
    <CourseCard
      title="React 基础"
      lessons={24}
      published={true}
    />
  );
}

预期结果

text
页面显示:
React 基础
共 24 课时
已发布

如果把 lessons={24} 写成 lessons="24",TypeScript 会提示字符串不能赋给数字类型;如果漏掉 published,也会提示缺少必填属性。这些错误会在运行前暴露。

类型选择与只读边界

对象形状既可以用 type,也可以用 interface。对于普通组件 Props,两者都能满足需求。团队应保持一致,不必为了简单场景频繁切换写法。

type 还便于组合联合类型,例如把状态限制为 "draft" | "published"。interface 更适合需要声明合并或面向对象扩展的场景,但这不是定义基础 Props 的必要条件。

保持只读思维

组件不应修改收到的 Props。即使对象字段在类型上没有显式写成 readonly,也应把它视为父组件提供的快照。需要变化时,由父组件更新数据并重新传入。

为了让类型更靠近使用位置,小型组件可以把 Props 类型写在同一文件中。被多个模块共享的业务类型再提取到独立文件,避免过早拆分。

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

目录与阅读设置

阅读设置

17

记录一个想法

定义 Props 类型

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

登录哪都通