use client
了解如何使用 use client 指令在客户端渲染组件。
'use client' 指令声明了一个入口点,用于指定要在客户端渲染的组件,在创建需要客户端 JavaScript 能力的交互式用户界面(UI)时应使用该指令,例如状态管理、事件处理以及访问浏览器 API。这是 React 的一项特性。
小知识:
您不需要为每个包含 Client Component 的文件都添加
'use client'指令。只需在那些希望其组件直接在 Server Component 中渲染的文件中添加即可。'use client'指令定义了服务端与客户端的边界,从此类文件导出的组件即为客户端的入口点。
用法#
要声明 Client Components 的入口点,请在文件顶部、任何导入之前添加 'use client' 指令。该指令作用于整个模块,不能放在组件或函数内部:
app/components/counter.tsx
'use client'
import { useState } from 'react'
export default function Counter() {
const [count, setCount] = useState(0)
return (
<div>
<p>Count: {count}</p>
<button onClick={() => setCount(count + 1)}>Increment</button>
</div>
)
}app/components/counter.js
'use client'
import { useState } from 'react'
export default function Counter() {
const [count, setCount] = useState(0)
return (
<div>
<p>Count: {count}</p>
<button onClick={() => setCount(count + 1)}>Increment</button>
</div>
)
}使用 'use client' 指令时,Client Components 的 props 必须可序列化。这意味着 props 需要采用 React 在从服务端向客户端发送数据时能够序列化的格式。
app/components/counter.tsx
'use client'
export default function Counter({
onClick /* ❌ 函数不可序列化 */,
}) {
return (
<div>
<button onClick={onClick}>Increment</button>
</div>
)
}app/components/counter.js
'use client'
export default function Counter({
onClick /* ❌ 函数不可序列化 */,
}) {
return (
<div>
<button onClick={onClick}>Increment</button>
</div>
)
}在 Server Components 中嵌套 Client Components#
结合使用 Server Components 和 Client Components,可让您构建既高性能又具交互性的应用:
- Server Components:用于静态内容、数据获取和 SEO 友好的元素。
- Client Components:用于需要状态、副作用或浏览器 API 的交互元素。
- 组件组合:根据需要在 Server Components 中嵌套 Client Components,以清晰分离服务端和客户端逻辑。
在下面的示例中:
Header是处理静态内容的 Server Component。Counter是使页面具有交互性的 Client Component。
app/page.tsx
import Header from './header'
import Counter from './counter' // 这是一个 Client Component
export default function Page() {
return (
<div>
<Header />
<Counter />
</div>
)
}app/page.js
import Header from './header'
import Counter from './counter' // 这是一个 Client Component
export default function Page() {
return (
<div>
<Header />
<Counter />
</div>
)
}参考#
有关 'use client' 的更多信息,请参阅 React 文档。