Pages Router
別名: ページルーター / pages ディレクトリ / pages directory
Next.js が pages/ ディレクトリで提供する従来のルーティング方式。
ファイル名がそのまま URL になり、getServerSideProps などのデータ取得関数と _app / _document による共通化を使う。
App Router とは同じプロジェクトに共存できる。
公開:
定義
Pages Router は、Next.js が pages/ ディレクトリで提供する従来のルーティング方式である。pages/ 配下に置いたファイルのパスがそのまま URL になり、default export したコンポーネントがページとして描画される。
App Router が登場する前から使われてきた方式で、現在も引き続きサポートされている。
詳細
ページは既定でクライアント側にも配られるコンポーネントで、サーバー側のデータ取得は決まった名前の関数を export して行う。getServerSideProps はリクエストごと、getStaticProps はビルド時、getStaticPaths は動的セグメントの事前生成に使う。
全ページ共通の処理は pages/_app.tsx、HTML の外枠は pages/_document.tsx が担当する。
pages/
_app.tsx ← 全ページ共通のラッパー
index.tsx ← /
blog/
[slug].tsx ← /blog/:slug
api/
hello.ts ← /api/hello(API Routes)<title> などのメタ情報は next/head の <Head> で差し込む。
App Router の metadata オブジェクトは、Pages Router では読まれない。
API は pages/api/ の API Routes が担当し、App Router の Route Handler とは書き方が異なる。
よくある誤解
- App Router が来ても、Pages Router が使えなくなったわけではない。
廃止されておらず、同じプロジェクトでapp/と併用できる。
ただし同じ URL を両方で定義することはできない。 app/向けの書き方は、そのままでは動かない。metadataexport・"use client"・Server Component は App Router の仕組みで、pages/配下では効かない。
関連
新しい方式は App Router、App Router 側の API 定義は Route Handler の項で説明している。
両方式の取り違えで起きる症状は、Next.js の metadata が反映されない にまとめてある。