React / 系统课时

划分组件边界

划分组件边界

服务端与客户端组件的边界不是按页面平均切分,而是由数据位置、交互需求和依赖能力共同决定。本课用一棵组件树建立判断顺序,并演示如何把 'use client' 下沉到最小交互区域,避免把大块页面意外打进客户端包。

学习目标

  • 能根据数据、交互和依赖判断组件应放在服务端还是客户端
  • 理解 'use client' 对模块依赖图的影响,并尽量缩小客户端边界
  • 能识别跨边界传值和组件组合中的常见错误

从三个问题判断边界

先看数据。如果组件需要直接访问数据库、服务器文件、私有凭据或只应在服务器出现的业务逻辑,应优先保留为服务端组件。这样数据在服务器完成读取和整形,只把页面真正需要展示的结果传向浏览器。

再看交互。如果组件需要 useState、useEffect、事件处理器、window、localStorage 或依赖浏览器环境的第三方库,它就需要位于客户端边界内。不要因为页面里有一个下拉框,就把整个页面都标成客户端组件。

最后看依赖。'use client' 放在某个模块顶部后,该模块以及它静态导入的依赖会进入客户端模块图。因此边界越靠近组件树根部,潜在的客户端 JavaScript 范围通常越大;把边界下沉到交互叶子节点,更容易控制体积和职责。

Next.js 服务端与客户端组件边界树

把客户端边界下沉到交互叶子

下面的页面展示商品信息和数量选择器。商品数据与主体标记都不需要在浏览器执行,因此保留在服务端;只有数量选择器需要状态与点击事件,所以单独成为客户端组件。

tsx
// app/page.tsx
import QuantityPicker from './quantity-picker';

async function getProduct() {
  // 示例用固定数据代替数据库,真实项目可在此执行服务器数据读取。
  return { id: 'p-100', name: '机械键盘', price: 699 };
}

export default async function Page() {
  const product = await getProduct();

  return (
    <main>
      <h1>{product.name}</h1>
      <p>价格:¥{product.price}</p>
      <QuantityPicker productId={product.id} />
    </main>
  );
}

// app/quantity-picker.tsx
'use client';

import { useState } from 'react';

export default function QuantityPicker({ productId }: { productId: string }) {
  const [quantity, setQuantity] = useState(1);

  // 客户端只维护交互状态,不重新承担商品数据读取职责。
  return (
    <section aria-label={`商品 ${productId} 的数量选择`}>
      <button onClick={() => setQuantity((value) => Math.max(1, value - 1))}>-</button>
      <span>数量:{quantity}</span>
      <button onClick={() => setQuantity((value) => value + 1)}>+</button>
    </section>
  );
}

预期结果

text
页面显示:机械键盘
页面显示:价格:¥699
数量初始为 1;点击 + 变为 2;数量为 1 时点击 - 仍保持 1

如果把 'use client' 直接写到 app/page.tsx,这个示例也能实现交互,但页面及其客户端依赖会被一起纳入客户端边界,失去“服务端主体 + 交互小岛”的清晰分工。

跨越边界时只传需要的东西

服务端组件可以渲染客户端组件,并通过 props 传递 React 能序列化的数据。传递商品 id、字符串、数字或用于展示的普通数据通常没有问题;不要把数据库连接、密钥、服务器对象或普通函数当作 props 直接送进客户端组件。

客户端组件也不应直接静态导入一个服务端组件模块。需要组合两类组件时,可以让更上层的服务端组件同时组织它们,再把已经构造好的服务端内容通过 children 或其他可接受的组件插槽交给客户端组件。这样“谁负责组合”仍在服务器一侧,客户端只负责自身交互。

用依赖方向做最后验收

完成拆分后,可以按一条简单规则复查:默认留在服务端,只有必须在浏览器执行的最小区域才进入客户端。如果一个客户端组件只为一个按钮服务,却导入了整套数据访问层、Markdown 解析器或大型 UI 依赖,说明边界或依赖方向仍值得调整。

反过来,也不要为了追求“零客户端 JavaScript”强行把交互搬走。状态、事件、浏览器 API 和客户端专用 Hook 本来就属于客户端。好的组件边界不是服务端组件越多越好,而是让数据读取、渲染和交互分别待在最合适的执行环境中。

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

目录与阅读设置

阅读设置

17

记录一个想法

划分组件边界

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

登录哪都通