React / 系统课时
使用 Props 传递数据
使用 Props 传递数据
本课将把固定内容的组件改造成可复用组件,演示父组件如何通过 Props 传递文本、对象、函数和可选参数。完成后,你可以为组件定义清晰输入,并避免在子组件中修改外部数据。
学习目标
- 能为 Props 定义 TypeScript 类型并接收多种数据
- 能传递回调函数,实现子组件向父组件报告事件
- 理解 Props 只读规则和可选参数的默认值
Props 是组件的只读输入
Props 是父组件调用子组件时提供的输入。JSX 属性名对应 Props 字段,字符串可以直接写,变量、对象、布尔值和函数要放在花括号中。子组件根据 Props 生成界面,但不应修改收到的值。
数据沿组件树向下传递,事件通常通过回调函数向上通知。这样可以让状态由父组件统一管理,子组件只关注展示与交互。

主示例:传递文本、对象和函数
下面示例把用户信息交给 UserCard 展示,并通过 onSelect 把点击结果通知父组件。badge 是可选参数,未传入时使用默认值。
tsx
// src/App.tsx
import { useState } from 'react'
type User = {
id: number
name: string
role: string
}
type UserCardProps = {
title: string
user: User
featured: boolean
onSelect: (userId: number) => void
badge?: string
}
function UserCard({
title,
user,
featured,
onSelect,
badge = '普通成员',
}: UserCardProps) {
return (
<article>
<h2>{title}</h2>
<p>{user.name} · {user.role}</p>
<p>{featured ? '重点推荐' : badge}</p>
<button onClick={() => onSelect(user.id)}>选择用户</button>
</article>
)
}
export default function App() {
const [selectedId, setSelectedId] = useState<number | null>(null)
const user: User = { id: 101, name: 'Lin', role: '前端工程师' }
return (
<main>
<UserCard
title="课程助教"
user={user}
featured={false}
onSelect={setSelectedId}
/>
<p>已选择:{selectedId ?? '暂无'}</p>
</main>
)
}预期结果
text
初始页面:
课程助教
Lin · 前端工程师
普通成员
[选择用户]
已选择:暂无
点击“选择用户”后:
已选择:101页面中的方括号只用于表示按钮。按钮文字实际显示为“选择用户”,不会包含方括号。
只读、解构与可选参数
Props 在组件内部应视为只读。不要执行 user.name = '新名称',因为这会修改父组件持有的对象。需要编辑数据时,应在父组件中创建新对象并更新状态,再把新值通过 Props 传回子组件。
参数解构可以直接取出字段,并在解构位置为可选字段提供默认值。可选字段使用 ? 标记,但“可选”不等于可以随意访问;没有默认值时,应先判断它是否为 undefined。
回调 Props 只传函数引用,不要写成 onSelect={setSelectedId(101)},否则函数会在渲染时立即执行。需要附带参数时,用箭头函数延迟到事件发生后执行。
按自己的节奏,确认真正理解。