Next.jsで学ぶReact講座 90日コース | Next.js基礎 - Day 39:Dynamic Routes

React Next.jsで学ぶReact講座90日コース
スポンサーリンク
スポンサーリンク

Day 39:Dynamic Routesでブログ詳細ページを作る

Day 39では、Next.jsのDynamic Routes(動的ルーティング)を学びます。今日は、/blog/1、/blog/2、/blog/3のように、URLの一部が変わるページを作りながら、URLパラメータの基本を理解します。Next.jsのApp Routerでは、app/blog/[id]/page.tsxのように角かっこ付きのフォルダー名を使うことで、動的なルートを定義できます。 (🔗 nextjs.org)

これまでの固定ページでは、/aboutや/contactのようにURLが最初から決まっていました。しかしブログ記事や商品詳細ページでは、1ページずつpage.tsxを増やすのではなく、ひとつの仕組みで複数の詳細ページを表示する必要があります。そこで使うのが動的ルーティングです。 (🔗 nextjs.org)

Day 39で学ぶこと

  • 動的ルーティングとは何か。
  • URLパラメータとは何か。
  • app/blog/[id]/page.tsxの意味。
  • /blog/1、/blog/2、/blog/3を1つの仕組みで表示する方法。
  • generateStaticParamsを使って、あらかじめ作るページを指定する方法。

動的ルーティングとは

動的ルーティングとは、URLの一部を変数のように扱うルーティングのことです。Next.jsでは、[id]や[slug]のように角かっこで囲んだフォルダー名を使うと、その部分が動的セグメントになります。たとえば、app/blog/[id]/page.tsxは、/blog/1や/blog/2のようなURLに対応できます。 (🔗 nextjs.org)

初心者向けに言い換えると、固定ページは「住所が完全に決まっている部屋」、動的ページは「部屋番号だけ変わる同じ型の部屋」です。ブログ記事詳細ページでは、表示する記事は違っても、ページの形はほぼ同じです。そのため、1つのpage.tsxで複数の記事ページを扱います。

URLパラメータとは

URLパラメータとは、URLの中から取り出して使う値です。今回の/blog/1なら、1の部分がURLパラメータです。/blog/2なら2、/blog/3なら3です。

Next.jsのApp Routerでは、動的ルートの値はparamsとしてページに渡されます。現在のNext.jsドキュメントでは、paramsはPromiseとして渡され、async/awaitまたはReactのuseで値を取り出します。たとえばapp/shop/[slug]/page.tsxでは、paramsからslugを取得する形が案内されています。 (🔗 nextjs.org)

今日作る完成イメージ

今回は、次のような簡単なブログを作ります。

  • /blog:記事一覧ページ。
  • /blog/1:記事1の詳細ページ。
  • /blog/2:記事2の詳細ページ。
  • /blog/3:記事3の詳細ページ。

ファイル構成は次のようにします。

src/
├── app/
│   ├── blog/
│   │   ├── [id]/
│   │   │   └── page.tsx
│   │   └── page.tsx
│   ├── globals.css
│   ├── layout.tsx
│   └── page.tsx
└── data/
    └── posts.ts

この構成では、blogフォルダーが/blog、その中の[id]フォルダーが/blog/1のような動的ページになります。 (🔗 nextjs.org)

まずは記事データを用意する

最初に、表示するブログ記事データを作ります。今回は学習用なので、データベースではなくローカルファイルに配列で持たせます。

src/data/posts.ts

// ブログ記事1件分の型を定義します
export type Post = {
  id: string;
  title: string;
  body: string;
};

// 学習用のブログ記事データです
export const posts: Post[] = [
  {
    id: "1",
    title: "Next.jsを学び始める",
    body: "Next.jsはReactを使ったアプリ開発を進めやすくするフレームワークです。",
  },
  {
    id: "2",
    title: "App Routerの基本",
    body: "App Routerでは、appディレクトリのフォルダー構成でルーティングを定義します。",
  },
  {
    id: "3",
    title: "Dynamic Routes入門",
    body: "Dynamic Routesを使うと、URLの一部を変数のように扱って詳細ページを作れます。",
  },
];
TypeScript

ここでidを文字列にしているのは、URLパラメータは文字列として扱うことが多いためです。数字に見えても、URLから受け取る値は文字列として考える癖を付けると混乱が減ります。

記事一覧ページを作る

次に、/blogで記事一覧を表示します。ここから各詳細ページへ移動できるようにします。

src/app/blog/page.tsx

// Next.jsのリンク機能を読み込みます
import Link from "next/link";

// 記事データを読み込みます
import { posts } from "../../data/posts";

// ブログ一覧ページです
export default function BlogPage() {
  return (
    <section>
      <h1>ブログ一覧</h1>
      <p>記事を選ぶと詳細ページへ移動します。</p>

      <ul>
        {posts.map((post) => (
          // 各記事のidをkeyに使います
          <li key={post.id}>
            <Link href={`/blog/${post.id}`}>
              {post.title}
            </Link>
          </li>
        ))}
      </ul>
    </section>
  );
}
TSX

このコードで大切なのは、href={/blog/${post.id}}です。記事ごとに異なるURLを作っています。idが1なら/blog/1、2なら/blog/2になります。

Next.jsのLinkはアプリ内ページ移動のための主要な方法で、クライアントサイドナビゲーションや最適化された移動を提供します。詳細ページへの内部リンクでも、まずLinkを使うのが基本です。 (🔗 nextjs.org)

動的詳細ページを作る

ここが今日の中心です。src/app/blog/[id]/page.tsxを作ります。

src/app/blog/[id]/page.tsx

// 記事データを読み込みます
import { posts } from "../../../data/posts";

// URLパラメータの型を定義します
type BlogDetailPageProps = {
  params: Promise<{
    id: string;
  }>;
};

// ブログ詳細ページです
export default async function BlogDetailPage({
  params,
}: BlogDetailPageProps) {
  // paramsからidを取り出します
  const { id } = await params;

  // idに一致する記事を探します
  const post = posts.find((item) => item.id === id);

  // 該当記事が見つからない場合の表示です
  if (!post) {
    return (
      <section>
        <h1>記事が見つかりません</h1>
        <p>指定された記事は存在しません。</p>
      </section>
    );
  }

  return (
    <article>
      <h1>{post.title}</h1>
      <p>記事ID:{post.id}</p>
      <p>{post.body}</p>
    </article>
  );
}
TSX

このファイル名の[id]が重要です。ここが「変わる部分」です。URLが/blog/1ならidは"1"、/blog/2なら"2"になります。Next.js公式でも、app/shop/[slug]/page.tsxのような形で動的セグメントを作り、paramsから値を取り出す形が説明されています。 (🔗 nextjs.org)

paramsを深く理解する

初心者がつまずきやすいので、ここは丁寧に整理します。

たとえばURLが/blog/2だったとします。このとき、[id]の中に入る値は2です。Next.jsはそれをparamsとしてページに渡します。

今回のコードでは、次の部分がそれにあたります。

// paramsからidを取り出します
const { id } = await params;
TSX

これは「URLに入っていたidを取り出して、変数idに入れる」という意味です。つまり、URLを見て表示内容を切り替える仕組みです。

現在のNext.jsのpageファイルでは、paramsはPromiseとして渡されるため、await paramsの形で受け取るのが公式に沿った書き方です。Next.js 15では同期的なアクセスも後方互換のため一時的に可能ですが、将来的に非推奨になる予定と案内されています。 (🔗 nextjs.org)

/blog/1、/blog/2、/blog/3を事前に用意する

今回は、存在する記事が最初から1、2、3と分かっています。そのため、generateStaticParamsを使って、これらのページをあらかじめ静的生成対象として返せます。

src/app/blog/[id]/page.tsx を強化した完成版

// 記事データを読み込みます
import { posts } from "../../../data/posts";

// URLパラメータの型です
type BlogDetailPageProps = {
  params: Promise<{
    id: string;
  }>;
};

// 事前に生成するid一覧を返します
export async function generateStaticParams() {
  // 各記事のidを動的ルート用のパラメータとして返します
  return posts.map((post) => ({
    id: post.id,
  }));
}

// ブログ詳細ページです
export default async function BlogDetailPage({
  params,
}: BlogDetailPageProps) {
  // URLからidを取得します
  const { id } = await params;

  // idに一致する記事を検索します
  const post = posts.find((item) => item.id === id);

  // 記事が見つからない場合の表示です
  if (!post) {
    return (
      <section>
        <h1>記事が見つかりません</h1>
        <p>指定された記事は存在しません。</p>
      </section>
    );
  }

  return (
    <article>
      <h1>{post.title}</h1>
      <p>記事ID:{post.id}</p>
      <p>{post.body}</p>
    </article>
  );
}
TSX

generateStaticParamsは、動的ルートと組み合わせて、どのパラメータのページをビルド時に静的生成するかを返す関数です。公式ドキュメントでも、generateStaticParamsは動的セグメント用のパラメータ一覧を返し、getStaticPathsの後継として案内されています。 (🔗 nextjs.org)

今回なら、[{ id: "1" }, { id: "2" }, { id: "3" }]を返すイメージです。これにより、/blog/1、/blog/2、/blog/3が対象になります。

なぜgenerateStaticParamsを使うのか

初心者向けに簡単に言うと、「この3記事の詳細ページは最初からあると分かっているので、先に準備しておく」という考え方です。

公式では、generateStaticParamsはビルド時に動的ルートのパスを静的生成するために使うと説明されています。たとえばブログ記事の一覧が事前に分かっているなら、その記事分だけページをあらかじめ作っておけます。 (🔗 nextjs.org)

今回は学習用なので、「1、2、3の記事ページを事前に用意する仕組み」と理解できれば十分です。

トップページからブログへ移動できるようにする

学習しやすいように、トップページからブログ一覧へ移動するリンクも用意しておくと便利です。

src/app/page.tsx

// Next.jsのリンク機能を読み込みます
import Link from "next/link";

// トップページです
export default function HomePage() {
  return (
    <section>
      <h1>ホーム</h1>
      <p>Day 39では、動的ルーティングでブログ詳細ページを作ります。</p>

      <p>
        <Link href="/blog">ブログ一覧を見る</Link>
      </p>
    </section>
  );
}
TSX

これで、トップページ → ブログ一覧 → ブログ詳細、という流れで確認しやすくなります。

見た目を少し整える

必要ならsrc/app/globals.cssに次のようなスタイルを追加できます。

/* ページ全体の基本設定です */
body {
  margin: 0;
  font-family: sans-serif;
  line-height: 1.7;
  color: #222;
  background: #f7f7f7;
}

/* 本文の横幅を整えます */
main,
section,
article {
  max-width: 800px;
  margin: 0 auto;
  padding: 24px 16px;
}

/* 記事一覧のリンクを見やすくします */
a {
  color: #2563eb;
  text-decoration: none;
}

a:hover {
  text-decoration: underline;
}

見た目は本題ではありませんが、リンクやページの切り替わりを確認しやすくなるため、最低限整えておくと学習効率が上がります。

動作確認の手順

次の順番で確認してください。

  • /blogを開き、記事一覧が表示されるか確認します。
  • 記事1のリンクを押して、/blog/1へ移動するか確認します。
  • 記事2のリンクを押して、/blog/2へ移動するか確認します。
  • 記事3のリンクを押して、/blog/3へ移動するか確認します。
  • URLを直接入力しても、それぞれの記事が表示されるか確認します。
  • 存在しないIDを指定したときの表示も確認します。

学習では、クリックだけでなくURL直接入力も試すことが大切です。動的ルーティングはURLの仕組みなので、ブラウザーのアドレスバーから確認すると理解が深まります。

よくあるつまずき

  • `blog/[id].tsx`のように作ってしまう:App Routerでは、`[id]`はフォルダー名です。正しくは`app/blog/[id]/page.tsx`です。
  • `params.id`をそのまま同期的に使ってしまう:現在の公式では`params`はPromiseなので、`await params`で値を取り出します。
  • IDを数字だと思い込む:URLから受け取る値は基本的に文字列として扱います。
  • 記事が見つからない場合を考えていない:存在しないIDのときの表示も用意しておくと安全です。
  • 記事ごとに`page.tsx`を増やそうとする:動的ルートなら1つの詳細ページで複数記事を扱えます。

初心者向けテンプレート

動的ルーティングの最小テンプレートも載せておきます。

// URLパラメータの型です
type PageProps = {
  params: Promise<{
    id: string;
  }>;
};

// 動的詳細ページです
export default async function Page({ params }: PageProps) {
  // URLからidを取得します
  const { id } = await params;

  return (
    <section>
      <h1>詳細ページ</h1>
      <p>IDは {id} です。</p>
    </section>
  );
}
TSX

このテンプレートを理解しておけば、ブログ詳細、商品詳細、ユーザー詳細などに応用できます。

セキュリティと注意点

URLパラメータは、利用者が自由に変更できます。つまり、/blog/1を/blog/999に書き換えることもできます。そのため、URLパラメータをそのまま信じず、本当に存在するデータか確認することが大切です。

今回はローカル配列からfind()で探していますが、将来データベースやAPIを使う場合でも考え方は同じです。

  • URLパラメータは利用者入力の一種として扱います。
  • 見つからない場合の表示を用意します。
  • 将来APIやDBを使うなら、サーバー側でも存在確認が必要です。

動的ルートは便利ですが、「URLが変えられる」という前提を忘れないことが安全な設計につながります。

Day 39のチェックリスト

  • 動的ルーティングが、URLの一部を変数のように扱う仕組みだと説明できます。
  • app/blog/[id]/page.tsxで詳細ページを作れます。
  • paramsからURLパラメータを取り出せます。
  • /blog/1、/blog/2、/blog/3を1つのページ構造で表示できます。
  • generateStaticParamsで、事前に生成するルートを指定できます。
  • 存在しないIDのときの表示を用意できます。

まとめ

Day 39では、Dynamic RoutesとURLパラメータを使って、ブログ詳細ページを作りました。app/blog/[id]/page.tsxという1つの仕組みで、/blog/1、/blog/2、/blog/3のような複数の詳細ページを表示できるのがポイントです。 (🔗 nextjs.org)

また、paramsからURLの値を取り出し、generateStaticParamsで事前にページを生成する流れも学びました。これはブログだけでなく、商品ページ、プロフィールページ、カテゴリーページなど、多くのNext.jsアプリで使う重要な基礎です。 (🔗 nextjs.org)

タイトルとURLをコピーしました