default.js

يُستخدم ملف default.js لعرض بديل احتياطي داخل المسارات المتوازية (Parallel Routes) عندما لا يتمكن Next.js من استعادة الحالة النشطة للفتحة (slot) بعد تحميل الصفحة بالكامل.

أثناء التنقل الناعم (soft navigation)، يحتفظ Next.js بتتبع الحالة النشطة (الصفحة الفرعية) لكل فتحة. ومع ذلك، بالنسبة للتنقلات الصلبة (تحميل الصفحة بالكامل)، لا يمكن لـ Next.js استعادة الحالة النشطة. في هذه الحالة، يمكن عرض ملف default.js للصفحات الفرعية التي لا تتطابق مع عنوان URL الحالي.

خذ بعين الاعتبار هيكل المجلدات التالي. تحتوي فتحة @team على صفحة settings، بينما لا تحتوي فتحة @analytics عليها.

المسارات المتوازية - مسارات غير متطابقة

عند التنقل إلى /settings، ستعرض فتحة @team صفحة settings مع الحفاظ على الصفحة النشطة الحالية لفتحة @analytics.

عند التحديث، سيقوم Next.js بعرض ملف default.js لـ @analytics. إذا لم يكن default.js موجودًا، فسيتم عرض خطأ 404 بدلاً من ذلك.

بالإضافة إلى ذلك، نظرًا لأن children هي فتحة ضمنية، فأنت بحاجة أيضًا إلى إنشاء ملف default.js لعرض بديل احتياطي لـ children عندما لا يتمكن Next.js من استعادة الحالة النشطة للصفحة الأصلية.

الخصائص (Props)

params (اختياري)

كائن يحتوي على معلمات المسار الديناميكي (dynamic route parameters) من الجزء الجذري وصولاً إلى الصفحات الفرعية للفتحة. على سبيل المثال:

مثالعنوان URLparams
app/@sidebar/[artist]/default.js/zack{ artist: 'zack' }
app/@sidebar/[artist]/[album]/default.js/zack/next{ artist: 'zack', album: 'next' }