React / 系统课时

使用客户端组件

使用客户端组件

本课通过计数器学习客户端组件的最小用法。你将使用 'use client' 建立客户端边界,并在浏览器中运行状态更新与点击事件。

学习目标

  • 使用 'use client' 声明客户端入口
  • 在客户端组件中使用状态与事件
  • 控制进入客户端 JavaScript 包的组件范围

客户端边界的含义

在文件顶部写入 'use client',该文件就成为客户端组件入口。它导入的组件和依赖也会进入客户端模块图,因此指令应放在真正需要交互的较小组件上,而不是习惯性放到整个页面或根布局。

客户端组件可以使用 useState、useEffect、事件处理器、window 和 localStorage 等浏览器能力。它仍可能参与服务端预渲染,但交互逻辑最终需要在浏览器中完成水合并运行。

创建交互计数器

下面是片段示例,需要分别保存到对应文件。页面保持为服务端组件,只把计数器这一小块交互区域放到客户端。

tsx
// app/counter/counter.tsx
'use client'

import { useState } from 'react'

export default function Counter() {
  const [count, setCount] = useState(0)

  return (
    <section>
      <p>当前计数:{count}</p>
      <button onClick={() => setCount((value) => value + 1)}>
        增加
      </button>
    </section>
  )
}

// app/counter/page.tsx
import Counter from './counter'

export default function CounterPage() {
  return (
    <main>
      <h1>客户端计数器</h1>
      <p>下面的按钮状态只在浏览器中更新。</p>
      <Counter />
    </main>
  )
}

预期结果:页面初始显示计数 0,每点击一次“增加”按钮,数字加一且页面无需重新导航。

text
初始:当前计数 0
点击一次:当前计数 1
点击两次:当前计数 2

避免扩大客户端范围

不要因为页面中有一个按钮,就给整个 page.tsx 添加 'use client'。更好的做法是保留服务端页面的数据读取能力,把按钮、表单或浏览器 API 封装成小型客户端组件。

客户端组件接收来自服务端的属性时,这些值必须能由 React 序列化。普通字符串、数字、布尔值和由它们组成的数据对象通常最合适;事件回调等函数不能作为普通属性从服务端直接传入客户端。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用客户端组件

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

登录哪都通