ページの追加(ファイルベースルーティング)

App Routerの中心的な仕組みであるファイルベースルーティングを体験するために、実際に新しいページを追加します。まずは静的なパス(/about)、次に動的なパス(/products/[id])の順で、URLとファイルの対応関係を実際に操作しながら把握します。

/about ページの追加

App Routerで新しいページを追加するときは、app/ 配下に対応するフォルダを作り、その中に page.tsx を置きます。/about にアクセスできるようにするために、app/about/page.tsx を作成します。

Visual Studio Codeのエクスプローラーで app フォルダを右クリックし、「新しいフォルダー」を選択して about という名前でフォルダを作成します。次に、作成した about フォルダを右クリックして「新しいファイル」から page.tsx を作成します。

my-next-app/
├── app/
│   ├── about/
│   │   └── page.tsx  ← このファイルを作成
│   ├── favicon.ico
│   ├── globals.css
│   ├── layout.tsx
│   ├── page.module.css
│   └── page.tsx
├── public/
├── next.config.ts
├── package.json
└── tsconfig.json

作成した app/about/page.tsx に以下の内容を記述して保存します。

export default function AboutPage() {
  return (
    <div>
      <h1>About</h1>
      <p>このページはApp Routerのファイルベースルーティングで追加されました。</p>
    </div>
  );
}

保存できたら、ブラウザで http://localhost:3000/about を開きます。「About」という見出しと、追加した本文が表示されていれば、ファイルベースルーティングが動作しています。

コードを解説します。

export default function AboutPage() {

app/page.tsx と同じく、export default された関数がそのままページ本体として扱われます。app/about/ フォルダに配置したことで、URLは自動的に /about に割り当てられます。ルーティング用の設定ファイル(routes.ts のようなもの)を書く必要はありません。

/products/[id] の動的ルーティング追加

静的なパスが動くことは確認できましたが、実際のアプリケーションでは「商品ID」「ユーザID」など、URLの一部が可変になるケースが多くあります。App Routerでは、フォルダ名を [id] のように角括弧で囲むことで、その部分を動的セグメントとして扱えます。書き方は以下のとおりです。

app/
└── パス名/
    └── [セグメント名]/
        └── page.tsx     ← `/パス名/任意の値` に対応する動的ルーティング

以下は、/products/任意のID に対応する動的ルーティングを追加する例です。

Visual Studio Codeのエクスプローラーで app フォルダを右クリックし、「新しいフォルダー」から products フォルダを作成します。次に、作成した products フォルダを右クリックして、「新しいフォルダー」から [id] フォルダを作成します(角括弧を含めて [id] という名前にします)。最後に、その [id] フォルダの中に page.tsx を作成します。

my-next-app/
├── app/
│   ├── about/
│   │   └── page.tsx
│   ├── products/
│   │   └── [id]/
│   │       └── page.tsx  ← このファイルを作成
│   ├── favicon.ico
│   ├── globals.css
│   ├── layout.tsx
│   ├── page.module.css
│   └── page.tsx
├── public/
├── next.config.ts
├── package.json
└── tsconfig.json

動的セグメントの値は、コンポーネントに渡される params プロパティで受け取ります。書き方は以下のとおりです。

export default async function 関数名({
  params,
}: {
  params: Promise<{ セグメント名: string }>;
}) {
  const { セグメント名 } = await params;
  // 処理
}

以下は、[id] セグメントの値を受け取って画面に表示する例です。作成した app/products/[id]/page.tsx に、以下の内容を記述して保存します。

export default async function ProductPage({
  params,
}: {
  params: Promise<{ id: string }>;
}) {
  const { id } = await params;

  return (
    <div>
      <h1>商品詳細</h1>
      <p>商品ID: {id}</p>
    </div>
  );
}

保存できたら、ブラウザで http://localhost:3000/products/123 を開きます。「商品ID: 123」と表示されていれば、動的ルーティングが動作しています。URLの数字部分を 456 などに変えると、表示される商品IDも追随して変わります。

コードを解説します。

export default async function ProductPage({
  params,
}: {
  params: Promise<{ id: string }>;
}) {

page.tsx のコンポーネントには、Next.jsから params などのpropsが自動で渡されます。App Router(Next.js 15以降)では params は Promise として渡されるため、コンポーネントを async にして await で解決する必要があります。型定義は Promise<{ id: string }> の部分で、URLの [id] セグメントに対応する id プロパティを持つオブジェクトが解決されることを表しています。

const { id } = await params;

await params で Promise を解決してから、id プロパティを分割代入で取り出しています。この id に、URLの [id] 部分に入っている値(例: /products/123 なら "123")が入ります。

📝 動的セグメントの命名ルール
フォルダ名の角括弧に囲んだ名前([id] の id 部分)が、そのまま params オブジェクトのキー名になります。[slug] にすれば params.slug、[postId] にすれば params.postId になります。この命名はコード側と一致させる必要があります。詳しくはDynamic Routes(Next.js公式ドキュメント)に記載があります。