الفرق بين المراجعتين لصفحة: «Next.js/automatic static optimization»
< Next.js
لا ملخص تعديل |
لا ملخص تعديل |
||
| سطر 2: | سطر 2: | ||
تقرر Next.js أن الصفحة ساكنة (أي يمكن تصييرها مسبقًا) إن لم يتطلب تصييرها معلومات محجوبة عنها، وذلك بخلو شيفرتها من الدالتين <code>getServerSideProps</code> و <code>getInitialProps</code>. | تقرر Next.js أن الصفحة ساكنة (أي يمكن تصييرها مسبقًا) إن لم يتطلب تصييرها معلومات محجوبة عنها، وذلك بخلو شيفرتها من الدالتين <code>getServerSideProps</code> و <code>getInitialProps</code>. | ||
تتيح ميزة التحسين الساكن التلقائي في Next.js نشر تطبيقات هجينة تتضمن صفحات تُصيَّر من ناحية الخادم وأخرى توّلد بشكل ساكن. ومن أهم منافع هذه الميزة أن الصفحات المحسّنة لن تحتاج أية حسابات من ناحية | تتيح ميزة التحسين الساكن التلقائي في Next.js نشر تطبيقات هجينة تتضمن صفحات تُصيَّر من ناحية الخادم وأخرى توّلد بشكل ساكن. ومن أهم منافع هذه الميزة أن الصفحات المحسّنة لن تحتاج أية حسابات من ناحية الخادم، وبالإمكان نقلها مباشرة إلى المستخدم النهائي انطلاقًا من مواقع عدة لشبكة توزيع المحتوى. وستكون النتيجة سرعة تحميل عالية جدًا تحسّن من تجربة مستخدميك.<blockquote>'''ملاحظة''': ستبقى الصفحات الموّلدة بشكل ساكن تفاعلية لأن Next.js سترطب التطبيق Hydration من جانب العميل لمنحه القدرة الكاملة على التفاعل مع المستخدم.</blockquote> | ||
== كيف تعمل ميزة التحسين الساكن في Next.js == | == كيف تعمل ميزة التحسين الساكن في Next.js == | ||
إن وجدت Next.js إحدى الدالتين <code>getServerSideProps</code> أو <code>getInitialProps</code> | إن وجدت Next.js إحدى الدالتين <code>getServerSideProps</code> أو <code>getInitialProps</code> في صفحة، ستتحول إلى طريقة التصيير عند الحاجة، ولكل طلب على حدى (تصيير من جانب الخادم). فإن لم يكن الوضع كذلك، ستحسّن Next.js الصفحة بشكل ساكن تلقائيًا بتصييرها مسبقًا إلى صفحة HTML ساكنة. | ||
سيكون الكائن <code>query</code> الخاص بالموّجهة فارغًا خلال مرحلة التصيير المسبق لعدم وجود معلومات ندفعها إلى الكائن خلال هذه المرحلة. لكن ما يحدث بعد الترطيب، أن Next.js ستسبب تحديث التطبيق لتأمين معاملات المسار التي يضمها الكائن <code>query</code>. سيُحدَّث الكائن <code>query</code> | سيكون الكائن <code>query</code> الخاص بالموّجهة فارغًا خلال مرحلة التصيير المسبق لعدم وجود معلومات ندفعها إلى الكائن خلال هذه المرحلة. لكن ما يحدث بعد الترطيب، أن Next.js ستسبب تحديث التطبيق لتأمين معاملات المسار التي يضمها الكائن <code>query</code>. سيُحدَّث الكائن <code>query</code> إن كان الترطيب سببًا في حدوث تصيير آخر في الحالات الآتية: | ||
* الصفحة عبارة عن وجهة ديناميكية. | * الصفحة عبارة عن وجهة ديناميكية dynamic route. | ||
* | * هناك قيم استعلام في عنوان URL للصفحة. | ||
* تهيئة الإعداد [[Next.js/next.config.js|<code>Rewrites</code>]] في ملف <code>next.config.js</code> | * تهيئة الإعداد [[Next.js/next.config.js|<code>Rewrites</code>]] في ملف <code>next.config.js</code>، فقد يتضمن معاملات يؤمنها الكائن <code>query</code> وتحتاج إلى التحليل. | ||
وإن أردت أن تعرف أن الاستعلام قد حُدِّث تمامًا وأصبح جاهزًا للاستخدام، بإمكانك تفعيل الحقل <code>isReady</code> في المكوّن [[Next.js/api router|<code>next/router</code>]].<blockquote>'''ملاحظة''': تبقى المعاملات التي تضيفها الوجهات الديناميكة إلى الصفحات التي تستخدم الدالة <code>getStaticProps</code> متاحةً دائمًا ضمن الكائن <code>query</code>.</blockquote>يعطي تنفيذ الأمر <code>next build</code> ملفات <code>html.</code> للصفحات المحسّنة بشكل ساكن، وستكون نتيجة الصفحة <code>pages/about.js</code> مثلًا على الشكل:<syntaxhighlight lang="bash"> | |||
.next/server/pages/about.html | .next/server/pages/about.html | ||
</syntaxhighlight>وإن أضفت <code>getServerSideProps</code> إلى الصفحة، فستكون صفحة JavaScript كالتالي:<syntaxhighlight lang="bash"> | </syntaxhighlight>وإن أضفت <code>getServerSideProps</code> إلى الصفحة، فستكون صفحة JavaScript كالتالي:<syntaxhighlight lang="bash"> | ||
| سطر 22: | سطر 22: | ||
* إن كان لديك [[Next.js/custom app|تطبيق مخصص]] يستخدم الدالة <code>getInitialProps</code>، فسيُعطًّل التحسين في الصفحات التي لا تدعم التوليد الساكن. | * إن كان لديك [[Next.js/custom app|تطبيق مخصص]] يستخدم الدالة <code>getInitialProps</code>، فسيُعطًّل التحسين في الصفحات التي لا تدعم التوليد الساكن. | ||
* إن كان لديك [[Next.js/ custom document|مستند مخصص]] يستخدم الدالة <code>getInitialProps</code>، تأكد من قيمة <code>ctx.req</code> قبل أن تفترض أن الصفحة ستُصيَّر من جانب الخادم. إذ يأخذ الخيار | * إن كان لديك [[Next.js/custom document|مستند مخصص]] يستخدم الدالة <code>getInitialProps</code>، تأكد من قيمة <code>ctx.req</code> قبل أن تفترض أن الصفحة ستُصيَّر من جانب الخادم. إذ يأخذ الخيار <code>ctx.req</code> القيمة <code>undefined</code> للصفحات التي تُصيّر مسبقًا. | ||
== المصادر == | == المصادر == | ||
* الصفحة [https://nextjs.org/docs/advanced-features/automatic-static-optimization Automatic Static Optimization] من توثيق Next.js الرسمي. | * الصفحة [https://nextjs.org/docs/advanced-features/automatic-static-optimization Automatic Static Optimization] من توثيق Next.js الرسمي. | ||
مراجعة 05:57، 4 يونيو 2022
تقرر Next.js أن الصفحة ساكنة (أي يمكن تصييرها مسبقًا) إن لم يتطلب تصييرها معلومات محجوبة عنها، وذلك بخلو شيفرتها من الدالتين getServerSideProps و getInitialProps.
تتيح ميزة التحسين الساكن التلقائي في Next.js نشر تطبيقات هجينة تتضمن صفحات تُصيَّر من ناحية الخادم وأخرى توّلد بشكل ساكن. ومن أهم منافع هذه الميزة أن الصفحات المحسّنة لن تحتاج أية حسابات من ناحية الخادم، وبالإمكان نقلها مباشرة إلى المستخدم النهائي انطلاقًا من مواقع عدة لشبكة توزيع المحتوى. وستكون النتيجة سرعة تحميل عالية جدًا تحسّن من تجربة مستخدميك.
ملاحظة: ستبقى الصفحات الموّلدة بشكل ساكن تفاعلية لأن Next.js سترطب التطبيق Hydration من جانب العميل لمنحه القدرة الكاملة على التفاعل مع المستخدم.
كيف تعمل ميزة التحسين الساكن في Next.js
إن وجدت Next.js إحدى الدالتين getServerSideProps أو getInitialProps في صفحة، ستتحول إلى طريقة التصيير عند الحاجة، ولكل طلب على حدى (تصيير من جانب الخادم). فإن لم يكن الوضع كذلك، ستحسّن Next.js الصفحة بشكل ساكن تلقائيًا بتصييرها مسبقًا إلى صفحة HTML ساكنة.
سيكون الكائن query الخاص بالموّجهة فارغًا خلال مرحلة التصيير المسبق لعدم وجود معلومات ندفعها إلى الكائن خلال هذه المرحلة. لكن ما يحدث بعد الترطيب، أن Next.js ستسبب تحديث التطبيق لتأمين معاملات المسار التي يضمها الكائن query. سيُحدَّث الكائن query إن كان الترطيب سببًا في حدوث تصيير آخر في الحالات الآتية:
- الصفحة عبارة عن وجهة ديناميكية dynamic route.
- هناك قيم استعلام في عنوان URL للصفحة.
- تهيئة الإعداد
Rewritesفي ملفnext.config.js، فقد يتضمن معاملات يؤمنها الكائنqueryوتحتاج إلى التحليل.
وإن أردت أن تعرف أن الاستعلام قد حُدِّث تمامًا وأصبح جاهزًا للاستخدام، بإمكانك تفعيل الحقل isReady في المكوّن next/router.
ملاحظة: تبقى المعاملات التي تضيفها الوجهات الديناميكة إلى الصفحات التي تستخدم الدالة
getStaticPropsمتاحةً دائمًا ضمن الكائنquery.
يعطي تنفيذ الأمر next build ملفات html. للصفحات المحسّنة بشكل ساكن، وستكون نتيجة الصفحة pages/about.js مثلًا على الشكل:
.next/server/pages/about.html
وإن أضفت getServerSideProps إلى الصفحة، فستكون صفحة JavaScript كالتالي:
.next/server/pages/about.js
التحفظات على ميزة التحسين الساكن في Next.js
- إن كان لديك تطبيق مخصص يستخدم الدالة
getInitialProps، فسيُعطًّل التحسين في الصفحات التي لا تدعم التوليد الساكن. - إن كان لديك مستند مخصص يستخدم الدالة
getInitialProps، تأكد من قيمةctx.reqقبل أن تفترض أن الصفحة ستُصيَّر من جانب الخادم. إذ يأخذ الخيارctx.reqالقيمةundefinedللصفحات التي تُصيّر مسبقًا.
المصادر
- الصفحة Automatic Static Optimization من توثيق Next.js الرسمي.