Routen-Gruppen

Routen-Gruppen sind eine Ordnerkonvention, die es Ihnen ermöglicht, Routen nach Kategorie oder Team zu organisieren.

Konvention

Eine Routen-Gruppe kann erstellt werden, indem der Name eines Ordners in Klammern gesetzt wird: (Ordnername).

Diese Konvention zeigt an, dass der Ordner nur organisatorischen Zwecken dient und nicht in den URL-Pfad der Route aufgenommen werden sollte.

Ein Beispiel für eine Ordnerstruktur mit Routen-Gruppen

Anwendungsfälle

  • Organisation von Routen nach Team, Anliegen oder Funktion.
  • Definition mehrerer Root-Layouts.
  • Auswahl bestimmter Routensegmente für die gemeinsame Nutzung eines Layouts, während andere ausgeschlossen bleiben.

Einschränkungen

  • Vollständiger Seitenladevorgang: Wenn Sie zwischen Routen mit unterschiedlichen Root-Layouts navigieren, wird ein vollständiger Neuladen der Seite ausgelöst. Zum Beispiel beim Wechsel von /cart, das app/(shop)/layout.js verwendet, zu /blog, das app/(marketing)/layout.js nutzt. Dies gilt nur für mehrere Root-Layouts.
  • Konfligierende Pfade: Routen in verschiedenen Gruppen sollten nicht auf denselben URL-Pfad aufgelöst werden. Beispielsweise würden (marketing)/about/page.js und (shop)/about/page.js beide auf /about aufgelöst werden und einen Fehler verursachen.
  • Top-Level Root-Layout: Wenn Sie mehrere Root-Layouts ohne eine Top-Level-layout.js-Datei verwenden, stellen Sie sicher, dass Ihre Startroute (/) innerhalb einer der Routen-Gruppen definiert ist, z.B. app/(marketing)/page.js.