NNext.js 中文网 GitHub

客户端渲染(CSR)

学习如何在 Pages Router 中实现客户端渲染。

在 React 中使用客户端渲染(CSR)时,浏览器会下载一个最小的 HTML 页面以及该页面所需的 JavaScript。然后使用 JavaScript 来更新 DOM 并渲染页面。当应用首次加载时,用户可能会在看到完整页面之前注意到轻微的延迟,这是因为在所有 JavaScript 下载、解析和执行完成之前,页面并不会完全渲染。

页面首次加载之后,在同一网站上导航到其他页面通常会更快,因为只需获取必要的数据,并且 JavaScript 可以重新渲染页面的部分内容,而无需刷新整个页面。

在 Next.js 中,有两种方式可以实现客户端渲染:

  1. 在你的页面中使用 React 的 useEffect() hook,而不是服务端渲染方法(getStaticProps 和 getServerSideProps)。
  2. 使用 SWR 或 TanStack Query 之类的数据获取库在客户端获取数据(推荐)。

以下是在 Next.js 页面中使用 useEffect() 的示例:

pages/index.js
import React, { useState, useEffect } from 'react'

export function Page() {
  const [data, setData] = useState(null)

  useEffect(() => {
    const fetchData = async () => {
      const response = await fetch('https://api.example.com/data')
      if (!response.ok) {
        throw new Error(`HTTP error! status: ${response.status}`)
      }
      const result = await response.json()
      setData(result)
    }

    fetchData().catch((e) => {
      // 根据需要处理错误
      console.error('An error occurred while fetching the data: ', e)
    })
  }, [])

  return <p>{data ? `Your data: ${data}` : 'Loading...'}</p>
}

在上面的示例中,组件首先渲染 Loading...。然后,一旦获取到数据,它就会重新渲染并显示数据。

虽然在 useEffect 中获取数据是你可能在较旧的 React 应用中见到的一种模式,但我们建议使用数据获取库,以获得更好的性能、缓存、乐观更新等。以下是使用 SWR 在客户端获取数据的最小示例:

pages/index.js
import useSWR from 'swr'

export function Page() {
  const { data, error, isLoading } = useSWR(
    'https://api.example.com/data',
    fetcher
  )

  if (error) return <p>Failed to load.</p>
  if (isLoading) return <p>Loading...</p>

  return <p>Your Data: {data}</p>
}

小知识:

请记住,CSR 可能会影响 SEO。一些搜索引擎爬虫可能不会执行 JavaScript,因此只能看到应用的初始空白或加载状态。对于网络连接或设备较慢的用户,这也可能导致性能问题,因为他们需要等待所有 JavaScript 加载并运行后才能看到完整页面。Next.js 推崇一种混合方式,允许你结合使用服务端渲染、静态站点生成和客户端渲染,具体取决于应用中每个页面的需求。在 App Router 中,你还可以使用带有 Suspense 的加载 UI在页面渲染时显示加载指示器。