App Router
別名: アップルーター / app ディレクトリ / app directory
Next.js の app/ ディレクトリを使うルーティング方式。
フォルダ構成がそのまま URL になり、既定が Server Component であること、layout / loading などの特別なファイル名で挙動を組み立てる点が特徴。
公開: 更新:
定義
App Router は、Next.js が app/ ディレクトリで提供するファイルシステムベースのルーティング方式である。
フォルダの階層がそのまま URL のセグメントになり、そのフォルダに置いた page.tsx がページとして描画される。
React Server Components を前提に設計されており、app/ 配下のコンポーネントは指定しない限りサーバー側で実行される。
詳細
ルートを構成するのは決まった名前のファイルである。page がページ本体、layout が複数ページで共有する外枠、loading が Suspense のフォールバック、error がエラー境界、route が Route Handler(新しいタブで開く) を表す。
フォルダを作っただけでは公開されず、page が無いセグメントは URL として存在しない。
app/
layout.tsx ← 全ページ共通の外枠
page.tsx ← /
blog/
page.tsx ← /blog
[slug]/
page.tsx ← /blog/:slugブラウザの API やイベントハンドラを使うファイルの先頭には "use client" を書き、クライアント側で動かす境界を明示する。
従来の pages/ ディレクトリ方式(Pages Router)とは同一プロジェクト内で共存できるが、同じ URL を両方で定義することはできない。
よくある誤解
app/にファイルを置いただけでは公開されない。
公開されるのはpageを持つセグメントだけで、components/のような同居フォルダは URL にならない。"use client"を書いても、サーバーで動かなくなるわけではない。
そのファイル以下がクライアント境界になるだけで、初期 HTML はサーバーで描画される。
関連
既定の実行単位については Server Component、クライアント境界の指定については "use client" の項で説明している。
404 が解消できない症状は App Router で page.tsx を置いても 404 にまとめてある。