التصيير الجزئي المسبق (PPR)

يتيح لك التصيير الجزئي المسبق (PPR) دمج المكونات الثابتة والديناميكية معًا في نفس المسار. تعرف على المزيد حول PPR.

استخدام التصيير الجزئي المسبق

التبني التدريجي (الإصدار 15)

في Next.js 15، يمكنك تبني التصيير الجزئي المسبق تدريجيًا في التخطيطات والصفحات عن طريق تعيين خيار ppr في next.config.js إلى incremental، وتصدير خيار تكوين المسار experimental_ppr في أعلى الملف:

import type { NextConfig } from 'next'

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

export default nextConfig
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    ppr: 'incremental',
  },
}

module.exports = nextConfig
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>
     </>
  };
}
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. يجب عليك الموافقة صراحةً على استخدام PPR لكل مسار.
  • experimental_ppr سيتم تطبيقه على جميع العناصر الفرعية لقطاع المسار، بما في ذلك التخطيطات والصفحات المتداخلة. لا تحتاج إلى إضافته إلى كل ملف، فقط إلى القطاع العلوي للمسار.
  • لتعطيل PPR للأجزاء الفرعية، يمكنك تعيين experimental_ppr إلى false في القطاع الفرعي.
الإصدارالتغييرات
v15.0.0تم تقديم القيمة التجريبية incremental
v14.0.0تم تقديم ppr التجريبي