React / 系统课时

使用 Props 传递数据

使用 Props 传递数据

本课将把固定内容的组件改造成可复用组件,演示父组件如何通过 Props 传递文本、对象、函数和可选参数。完成后,你可以为组件定义清晰输入,并避免在子组件中修改外部数据。

学习目标

  • 能为 Props 定义 TypeScript 类型并接收多种数据
  • 能传递回调函数,实现子组件向父组件报告事件
  • 理解 Props 只读规则和可选参数的默认值

Props 是组件的只读输入

Props 是父组件调用子组件时提供的输入。JSX 属性名对应 Props 字段,字符串可以直接写,变量、对象、布尔值和函数要放在花括号中。子组件根据 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)},否则函数会在渲染时立即执行。需要附带参数时,用箭头函数延迟到事件发生后执行。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Props 传递数据

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

登录哪都通