ページの追加(ファイルベースルーティング)
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公式ドキュメント)に記載があります。 |