مجموعات المسارات (Route Groups)

مجموعات المسارات هي اصطلاح مجلدات يسمح لك بتنظيم المسارات حسب الفئة أو الفريق.

الاصطلاح

يمكن إنشاء مجموعة مسارات عن طريق وضع اسم المجلد بين قوسين: (اسم_المجلد).

يشير هذا الاصطلاح إلى أن المجلد مخصص لأغراض تنظيمية ويجب ألا يتم تضمينه في مسار URL للمسار.

مثال على هيكل المجلدات باستخدام مجموعات المسارات

حالات الاستخدام

  • تنظيم المسارات حسب الفريق أو الاهتمام أو الميزة.
  • تعريف عدة تخطيطات جذرية.
  • اختيار أجزاء مسار محددة لمشاركة تخطيط معين، مع استبعاد أجزاء أخرى.

محاذير

  • تحميل الصفحة بالكامل: إذا انتقلت بين مسارات تستخدم تخطيطات جذرية مختلفة، فسيؤدي ذلك إلى إعادة تحميل الصفحة بالكامل. على سبيل المثال، الانتقال من /cart الذي يستخدم app/(shop)/layout.js إلى /blog الذي يستخدم app/(marketing)/layout.js. هذا ينطبق فقط على تخطيطات الجذر المتعددة.
  • مسارات متضاربة: لا ينبغي أن تحل المسارات في مجموعات مختلفة إلى نفس مسار URL. على سبيل المثال، (marketing)/about/page.js و (shop)/about/page.js سيحلان إلى /about مما سيسبب خطأ.
  • تخطيط الجذر الأساسي: إذا كنت تستخدم عدة تخطيطات جذرية دون وجود ملف layout.js أساسي، تأكد من تعريف مسار الصفحة الرئيسية (/) ضمن إحدى مجموعات المسارات، مثل app/(marketing)/page.js.