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 类型写在同一文件中。被多个模块共享的业务类型再提取到独立文件,避免过早拆分。
按自己的节奏,确认真正理解。