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ページを自分で追加できるか試してください。
次に読む記事
- Web開発の常識を変える! プログラミング初心者向けReact入門
- APIって何? プログラミング初心者向けNode.js入門ガイド
- なぜプロはTypeScriptを使う? JavaScriptを卒業するための入門ガイド
学習の進め方や質問先を検討する
Reactの基本を固めてから、ルーティングやサーバーの役割へ進むと、疑問を分けて質問できます。 CodeNestでは、AIへの質問や演習を通じたプログラミング学習を案内しています。対応する学習内容・必要な環境・利用条件をCodeNestの公式案内で確認し、今の課題に合うかを検討してください。
