ppr
Partial Prerendering(PPR)を使用すると、静的コンポーネントと動的コンポーネントを同じルート内で組み合わせることができます。PPRについてさらに詳しく学んでください。
Partial Prerenderingの使用
段階的な導入(バージョン15)
Next.js 15では、next.config.js
でppr
オプションをincremental
に設定し、ファイルの先頭でexperimental_ppr
ルート設定オプションをエクスポートすることで、レイアウトやページでPartial Prerenderingを段階的に導入できます。
next.config.ts
TypeScript
import type { NextConfig } from 'next'
const nextConfig: NextConfig = {
experimental: {
ppr: 'incremental',
},
}
export default nextConfig
app/page.tsx
TypeScript
import { Suspense } from "react"
import { StaticComponent, DynamicComponent, Fallback } from "@/app/ui"
export const experimental_ppr = true
export default function Page() {
return {
<>
<StaticComponent />
<Suspense fallback={<Fallback />}>
<DynamicComponent />
</Suspense>
</>
};
}
補足:
experimental_ppr
が設定されていないルートはデフォルトでfalse
となり、PPRを使用してプリレンダリングされません。各ルートで明示的にオプトインする必要があります。experimental_ppr
はルートセグメントのすべての子コンポーネント(ネストされたレイアウトとページを含む)に適用されます。すべてのファイルに追加する必要はなく、ルートの最上位セグメントにのみ追加します。- 子セグメントのPPRを無効にするには、子セグメントで
experimental_ppr
をfalse
に設定できます。
バージョン | 変更点 |
---|---|
v15.0.0 | 実験的なincremental の値が導入されました |
v14.0.0 | 実験的なppr が導入されました |