部分預渲染 (PPR)

部分預渲染 (Partial Prerendering,PPR) 讓您可以在同一個路由中結合靜態與動態元件。了解更多關於 PPR 的資訊。

使用部分預渲染

漸進式採用 (版本 15)

在 Next.js 15 中,您可以透過以下方式在 layoutspages 中漸進式採用部分預渲染:在 next.config.js 中將 ppr 選項設為 incremental,並在檔案頂部匯出 experimental_ppr 路由配置選項

import type { NextConfig } from 'next'

const nextConfig: NextConfig = {
  experimental: {
    ppr: 'incremental',
  },
}

export default nextConfig

須知事項:

  • 沒有設定 experimental_ppr 的路由預設為 false,不會使用 PPR 進行預渲染。您需要為每個路由明確啟用 PPR。
  • experimental_ppr 會套用至路由區段的所有子項目,包括巢狀的 layouts 和 pages。您不需要在每個檔案中都添加,只需在路由的頂層區段設定即可。
  • 若要為子區段停用 PPR,可以在子區段中將 experimental_ppr 設為 false
版本變更內容
v15.0.0引入實驗性 incremental
v14.0.0引入實驗性 ppr 功能

On this page