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 插槽。插槽数量过多通常说明组件承担了太多布局职责,应重新检查组件是否需要拆分。
按自己的节奏,确认真正理解。