客戶端渲染 (CSR)

在使用 React 進行客戶端渲染 (CSR) 時,瀏覽器會下載一個最小的 HTML 頁面以及頁面所需的 JavaScript。接著 JavaScript 會被用來更新 DOM 並渲染頁面。當應用程式首次載入時,使用者可能會注意到在完整頁面顯示前有輕微延遲,這是因為頁面必須在所有 JavaScript 下載、解析並執行後才會完全渲染。

在首次載入頁面後,導航至同一網站的其他頁面通常會更快,因為只需獲取必要的資料,且 JavaScript 可以重新渲染頁面的部分內容,而無需完整重新載入頁面。

在 Next.js 中,您可以透過兩種方式實現客戶端渲染:

  1. 在頁面中使用 React 的 useEffect() 鉤子,而非伺服器端渲染方法 (getStaticPropsgetServerSideProps)。
  2. 使用資料獲取函式庫如 SWRTanStack 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 來顯示頁面渲染過程中的載入指示器。