الفرق بين المراجعتين ل"Next.js/automatic static optimization"
جميل-بيلوني (نقاش | مساهمات) ط (مراجعة) |
|||
| سطر 5: | سطر 5: | ||
== كيف تعمل ميزة التحسين الساكن في 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> الخاص بالموّجهة router فارغًا خلال مرحلة التصيير المسبق لعدم وجود معلومات ندفعها إلى الكائن خلال هذه المرحلة. لكن ما يحدث بعد الترطيب، أن Next.js ستسبب تحديث التطبيق لتأمين معاملات المسار التي يضمها الكائن <code>query</code>. سيُحدَّث الكائن <code>query</code> إن كان الترطيب سببًا في حدوث تصيير آخر في الحالات الآتية: |
* الصفحة عبارة عن وجهة ديناميكية dynamic route. | * الصفحة عبارة عن وجهة ديناميكية dynamic route. | ||
| سطر 13: | سطر 13: | ||
* تهيئة الإعداد [[Next.js/next.config.js|<code>Rewrites</code>]] في ملف <code>next.config.js</code>، فقد يتضمن معاملات يؤمنها الكائن <code>query</code> وتحتاج إلى التحليل. | * تهيئة الإعداد [[Next.js/next.config.js|<code>Rewrites</code>]] في ملف <code>next.config.js</code>، فقد يتضمن معاملات يؤمنها الكائن <code>query</code> وتحتاج إلى التحليل. | ||
| − | وإن أردت أن تعرف أن الاستعلام قد حُدِّث تمامًا وأصبح جاهزًا للاستخدام، بإمكانك تفعيل الحقل <code>isReady</code> في المكوّن [[Next.js/ | + | وإن أردت أن تعرف أن الاستعلام قد حُدِّث تمامًا وأصبح جاهزًا للاستخدام، بإمكانك تفعيل الحقل <code>isReady</code> في المكوّن <code>[[Next.js/next router|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"> | ||
| سطر 19: | سطر 19: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | == | + | == محاذير == |
* إن كان لديك [[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> قبل أن تفترض أن الصفحة ستُصيَّر من جانب الخادم. إذ يأخذ الخيار <code>ctx.req</code> القيمة <code>undefined</code> للصفحات التي تُصيّر مسبقًا. | * إن كان لديك [[Next.js/custom document|مستند مخصص]] يستخدم الدالة <code>getInitialProps</code>، تأكد من قيمة <code>ctx.req</code> قبل أن تفترض أن الصفحة ستُصيَّر من جانب الخادم. إذ يأخذ الخيار <code>ctx.req</code> القيمة <code>undefined</code> للصفحات التي تُصيّر مسبقًا. | ||
| + | * تجنب استخدام القيمة <code>asPath</code> مع <code>next/router</code> في شجرة التصيير rendering tree حتى تصبح قيمة <code>isReady</code> من الموجه هي <code>true</code>، إذ تُضبط قيمة <code>asPath</code> في الصفحات الساكنة المُحسَّنة في طرف العميل لا في طرف الخادم فتأكد من استعمالها استعمالًا صحيحًا لتجنب الأخطاء، وانظر مثال [https://github.com/vercel/next.js/tree/canary/examples/active-class-name class-name] الذي يوضع إحدى طرق استعمال <code>asPath</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 الرسمي. | ||
مراجعة 11:22، 18 ديسمبر 2022
تقرر Next.js أن الصفحة ساكنة (أي يمكن تصييرها مسبقًا) إن لم يتطلب تصييرها معلومات محجوبة عنها، وذلك بخلو شيفرتها من الدالتين getServerSideProps و getInitialProps.
تتيح ميزة التحسين الساكن التلقائي في Next.js نشر تطبيقات هجينة تتضمن صفحات تُصيَّر من ناحية الخادم وأخرى توّلد بشكل ساكن. ومن أهم منافع هذه الميزة أن الصفحات المحسّنة لن تحتاج أية حسابات من ناحية الخادم، وبالإمكان نقلها مباشرة إلى المستخدم النهائي انطلاقًا من مواقع عدة لشبكة توزيع المحتوى. وستكون النتيجة سرعة تحميل عالية جدًا تحسّن من تجربة مستخدميك.
ملاحظة: ستبقى الصفحات الموّلدة بشكل ساكن تفاعلية لأن Next.js سترطب التطبيق Hydration من جانب العميل لمنحه القدرة الكاملة على التفاعل مع المستخدم.
كيف تعمل ميزة التحسين الساكن في Next.js
إن وجدت Next.js إحدى الدالتين getServerSideProps أو getInitialProps في صفحة، فستتحول إلى طريقة التصيير عند الحاجة، ولكل طلب على حدى (تصيير من جانب الخادم). فإن لم يكن الوضع كذلك، ستحسّن Next.js الصفحة بشكل ساكن تلقائيًا بتصييرها مسبقًا إلى صفحة HTML ساكنة.
سيكون الكائن query الخاص بالموّجهة router فارغًا خلال مرحلة التصيير المسبق لعدم وجود معلومات ندفعها إلى الكائن خلال هذه المرحلة. لكن ما يحدث بعد الترطيب، أن 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
محاذير
- إن كان لديك تطبيق مخصص يستخدم الدالة
getInitialProps، فسيُعطًّل التحسين في الصفحات التي لا تدعم التوليد الساكن. - إن كان لديك مستند مخصص يستخدم الدالة
getInitialProps، تأكد من قيمةctx.reqقبل أن تفترض أن الصفحة ستُصيَّر من جانب الخادم. إذ يأخذ الخيارctx.reqالقيمةundefinedللصفحات التي تُصيّر مسبقًا. - تجنب استخدام القيمة
asPathمعnext/routerفي شجرة التصيير rendering tree حتى تصبح قيمةisReadyمن الموجه هيtrue، إذ تُضبط قيمةasPathفي الصفحات الساكنة المُحسَّنة في طرف العميل لا في طرف الخادم فتأكد من استعمالها استعمالًا صحيحًا لتجنب الأخطاء، وانظر مثال class-name الذي يوضع إحدى طرق استعمالasPathكخاصية.
المصادر
- الصفحة Automatic Static Optimization من توثيق Next.js الرسمي.