NNext.js 中文网 GitHub

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,可让您构建既高性能又具交互性的应用:

  1. Server Components:用于静态内容、数据获取和 SEO 友好的元素。
  2. Client Components:用于需要状态、副作用或浏览器 API 的交互元素。
  3. 组件组合:根据需要在 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 文档。

Next.js 中文网