React / 系统课时

传递组件数据

传递组件数据

本课通过商品卡片串联属性传递、React 节点组合和服务端到客户端的数据边界。完成后,你将能设计复用组件,而不是把页面数据写死在组件内部。

学习目标

  • 使用属性传递组件所需的最小数据
  • 通过 React 节点插槽组合可复用界面
  • 保证跨服务端与客户端边界的数据可序列化

属性应表达组件契约

属性定义了组件需要什么,而不是暴露父组件的全部状态。商品卡片只需要名称、价格和操作区,就不应接收完整数据库记录。较小而明确的属性可以降低耦合,也便于测试和复用。

当服务端组件把属性传给客户端组件时,值必须能由 React 序列化。函数、类实例和仅存在于服务器的连接对象不适合作为普通属性跨越边界;交互逻辑应在客户端组件内部定义,或使用专门的服务端操作机制。

用组合保留扩展位置

下面是片段示例,需要分别保存到对应文件。ProductCard 使用 actions 接收任意 React 节点,因此卡片结构保持稳定,父页面可以按场景放入不同操作组件。

tsx
// components/product-card.tsx
import type { ReactNode } from 'react'

export default function ProductCard({
  name,
  price,
  actions,
}: {
  name: string
  price: number
  actions: ReactNode
}) {
  return (
    <article>
      <h2>{name}</h2>
      <p>价格:¥{price}</p>
      <div>{actions}</div>
    </article>
  )
}

// components/add-to-cart-button.tsx
'use client'

import { useState } from 'react'

export default function AddToCartButton({ productId }: { productId: string }) {
  const [added, setAdded] = useState(false)

  return (
    <button onClick={() => setAdded(true)} disabled={added}>
      {added ? '已加入购物车' : `加入商品 ${productId}`}
    </button>
  )
}

// app/products/page.tsx
import ProductCard from '@/components/product-card'
import AddToCartButton from '@/components/add-to-cart-button'

const products = [
  { id: '1', name: '机械键盘', price: 399 },
  { id: '2', name: '无线鼠标', price: 199 },
]

export default function ProductsPage() {
  return (
    <main>
      <h1>商品列表</h1>
      {products.map((product) => (
        <ProductCard
          key={product.id}
          name={product.name}
          price={product.price}
          actions={<AddToCartButton productId={product.id} />}
        />
      ))}
    </main>
  )
}

预期结果:页面显示两张结构一致的商品卡片;每个按钮维护自己的客户端状态,点击后只更新对应卡片的操作区。

text
机械键盘  ¥399  加入商品 1
无线鼠标  ¥199  加入商品 2

点击第一个按钮后:
机械键盘  ¥399  已加入购物车
无线鼠标  ¥199  加入商品 2

保持单向数据流

父组件准备数据并通过属性向下传递,子组件根据属性渲染。子组件需要改变界面状态时,应在合适的客户端边界内维护状态,或通过明确的操作请求更新服务器数据,不要直接修改父组件传入的对象。

组合适合解决“结构相同、局部内容不同”的问题。除了 actions,也可以使用常见的 children 插槽。插槽数量过多通常说明组件承担了太多布局职责,应重新检查组件是否需要拆分。

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

目录与阅读设置

阅读设置

17

记录一个想法

传递组件数据

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

登录哪都通