Группы маршрутов

Группы маршрутов — это соглашение по организации папок, которое позволяет упорядочивать маршруты по категориям или командам.

Соглашение

Группу маршрутов можно создать, заключив имя папки в круглые скобки: (folderName).

Это соглашение указывает, что папка предназначена для организационных целей и не должна включаться в 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.