Next.js入門|Reactとの違いとApp Routerで2ページを作る手順

Reactでコンポーネントを作れたら、URLごとにページを分ける方法や、サーバーでの処理が気になってきます。Next.jsは、こうしたWebアプリ開発の仕組みをまとめたReactフレームワークです。この記事では役割とレンダリングの違いを整理し、App Routerで2ページを表示するところまで試します。

Next.jsが担当すること

ReactはUIを組み立てるライブラリです。Next.jsはReactを土台に、ルーティング、サーバーでの描画、データ取得などを組み合わせる枠組みを提供します。Reactで作った画面はNext.jsなしでも公開できます。必要な機能や配信方法に合わせて採用を判断してください。

Next.jsにはApp RouterとPages Routerがあります。古い教材のpagesディレクトリと、この記事で使うappディレクトリの規則を混ぜないことが大切です。既存のPages Routerのコードが、単に古いという理由で動かなくなるわけではありません。

準備:ReactとNode.jsの基礎を確認する

コンポーネント、props、stateが分からない場合はReact入門を先に試してください。開発用PCには、Next.js公式のインストール手順に記載された条件を満たす、サポート中のNode.jsを用意します。公式文書の最低要件を満たすだけでなく、Node.js自体のサポート状況も確認します。

練習用プロジェクトを作る

既存プロジェクトの外でターミナルを開き、次を実行します。同名フォルダがある場合は別名にしてください。作成時には必要なパッケージをインターネットからダウンロードします。

npx create-next-app@latest next-practice

セットアップでカスタマイズを選ぶ場合は、TypeScriptとApp Routerを有効にし、この練習ではsrcディレクトリを使わない設定にします。他の項目は用途に応じて選べます。選択項目はバージョンで変わるため、表示が違う場合は公式手順を確認してください。既にsrcを使う設定で作った場合は、以下のappをsrc/appと読み替えます。

cd next-practice
npm run dev

ターミナルに表示されたローカルURLをブラウザで開きます。通常はhttp://localhost:3000ですが、別のポートが表示された場合はそのURLを使います。

app/page.tsxとapp/about/page.tsxを作る

生成されたapp/layout.tsxは残し、app/page.tsxを次の内容へ変更します。

import Link from 'next/link';

export default function HomePage() {
  return (
    <main>
      <h1>学習ホーム</h1>
      <Link href="/about">このページについて</Link>
    </main>
  );
}

次にappの中へaboutフォルダを作り、その中へpage.tsxを保存します。

export default function AboutPage() {
  return (
    <main>
      <h1>このページについて</h1>
      <p>Next.jsのルーティングを練習しています。</p>
    </main>
  );
}

ホームのリンクを押して/aboutへ移動し、「このページについて」が出れば成功です。App Routerでは、フォルダがURLの区切りになり、page.tsxがそのページを定義します。終了時はターミナルでCtrl+Cを押します。

SSRとSSG:いつHTMLを用意するか

  • SSR(リクエスト時のサーバー描画):要求に応じてサーバー側でHTMLを生成します。利用者や要求ごとに変わる内容に適しますが、処理や通信が遅ければ応答も遅くなります。
  • SSG(静的生成):ビルド時などにHTMLを事前生成し、再利用します。共通内容を配信しやすい一方、更新の反映方法を設計する必要があります。

Next.jsではデータ取得やキャッシュの設定なども描画方法に関わります。App RouterではServer ComponentsとClient Componentsの区別も学びます。クリックやブラウザの機能を使う部分ではClient Componentが必要になるため、静的な2ページが動いた後に進めましょう。

Next.jsを使うだけでSEO順位や表示速度が保証されるわけではありません。見出し、内容、メタデータ、画像サイズ、データ取得なども確認する必要があります。

表示されないときの確認点

  • /aboutが404:about/page.tsxという配置と名前か、appとsrc/appを混ぜていないか。
  • 起動できない:Node.jsの要件、パッケージのインストール結果、ターミナルのエラーを確認する。
  • ブラウザが接続できない:npm run devが動いているか、表示されたポートと一致するか。
  • 古い教材と場所が違う:App Router用の説明かPages Router用の説明かを確認する。

この例は開発サーバーでの練習です。公開前には、ビルド、実行環境、秘密情報の扱い、エラー時の表示などを別途確認します。次はaboutの文章を変え、もう1ページを自分で追加できるか試してください。

次に読む記事

学習の進め方や質問先を検討する

Reactの基本を固めてから、ルーティングやサーバーの役割へ進むと、疑問を分けて質問できます。 CodeNestでは、AIへの質問や演習を通じたプログラミング学習を案内しています。対応する学習内容・必要な環境・利用条件をCodeNestの公式案内で確認し、今の課題に合うかを検討してください。