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 序列化。普通字符串、数字、布尔值和由它们组成的数据对象通常最合适;事件回调等函数不能作为普通属性从服务端直接传入客户端。
按自己的节奏,确认真正理解。