ルートグループ

ルートグループは、ルートをカテゴリやチームごとに整理するためのフォルダ規約です。

規約

ルートグループは、フォルダ名を括弧で囲むことで作成できます: (folderName)

この規約は、フォルダが組織的な目的で使用され、ルートのURLパスに含まれないことを示します。

ルートグループを使用したフォルダ構造の例

ユースケース

  • チーム、関心事、機能ごとにルートを整理
  • 複数のルートレイアウトを定義
  • 特定のルートセグメントをレイアウト共有にオプトインしつつ、他のセグメントは除外

注意点

  • フルページロード: 異なるルートレイアウトを使用するルート間を移動すると、フルページリロードが発生します。例えば、app/(shop)/layout.jsを使用する/cartから、app/(marketing)/layout.jsを使用する/blogへの移動。これは複数のルートレイアウトがある場合のみ適用されます。
  • パスの競合: 異なるグループ内のルートが同じURLパスに解決されてはいけません。例えば、(marketing)/about/page.js(shop)/about/page.jsは両方とも/aboutに解決され、エラーが発生します。
  • トップレベルのルートレイアウト: トップレベルのlayout.jsファイルなしで複数のルートレイアウトを使用する場合、ホームルート(/)がルートグループの1つ内で定義されていることを確認してください(例: app/(marketing)/page.js)。

On this page