Next.jsの概要

まずはハンズオンに入る前に、Next.jsがどんなフレームワークで、なぜApp Routerを扱うのかを整理します。Server ComponentとClient Componentの違いも、この後のハンズオンで何度も出てくる中心的なキーワードなので、ここで基本の輪郭を把握しておきます。

1. Next.jsとは

Next.jsは、Reactを土台にしたフルスタックのWebアプリケーションフレームワークです。React単体では、ルーティング・ビルド設定・レンダリング方式・データ取得の仕組みなどを自分で用意する必要がありますが、Next.jsはそれらを標準機能として一通り備えており、ページ単位でレンダリング方式を選びながらアプリケーションを構築できます。

Next.jsが扱うレンダリング方式は主に3種類あります。

方式 略称 概要
クライアントサイドレンダリング CSR JavaScriptがブラウザで動いて画面を描画する。従来のReactの標準的な動き方に相当する
サーバサイドレンダリング SSR リクエスト時にサーバでHTMLを作って返す。動的なコンテンツを扱いつつ初期表示を速くできる
静的サイト生成 SSG ビルド時にHTMLを生成しておく。CDN配信と相性がよく、非常に高速に配信できる

Next.jsでは、これらをページ単位で使い分けられるのが大きな特徴です。ブログ記事の詳細ページはSSG、ログイン後のダッシュボードはSSR、と組み合わせられます。

Next.jsには、ページとルーティングを定義する仕組みとして App Router と Pages Router の2種類があります。Pages Routerは初期からある仕組みで、pages/ フォルダにファイルを置く方式です。App RouterはNext.js 13で導入された新しい方式で、app/ フォルダに page.tsx や layout.tsx を配置します。App RouterがNext.js公式の推奨方式であり、新規プロジェクトはApp Routerで作成することが推奨されています(Installation(Next.js公式ドキュメント)のcreate-next-appのプロンプト例に「Would you like to use App Router? (recommended) No / Yes」と明記されています)。本章では、このApp Routerを使ってハンズオンを進めます。

2. App Routerとは

App Routerは、app/ フォルダのファイルシステム構造そのものがそのままURLになるルーティング方式です。ページを追加したいときは、対応するフォルダとファイルを作るだけでURLが割り当てられます。書き方は以下のとおりです。

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

以下は、実際のファイルパスと割り当てられるURLの対応例です。

ファイルパス 割り当てられるURL
app/page.tsx /
app/about/page.tsx /about
app/products/list/page.tsx /products/list
app/products/[id]/page.tsx /products/123 など、[id] に任意の値が入る動的ルーティングになる

App Routerのもう1つの大きな特徴は、すべてのコンポーネントがデフォルトでServer Componentとして扱われる点です。従来のReactは「ブラウザで動くコンポーネント」を前提としていましたが、App Routerでは明示的に指定しない限りサーバ側で実行されます。「ブラウザで動かしたい」場合にだけ、ファイル冒頭に "use client" を書いてClient Componentに切り替えます。

3. React Server ComponentとClient Componentの違い

Server Componentは、名前の通りサーバ側で実行されるコンポーネントです。HTMLに変換された結果だけがブラウザに届き、コンポーネント自体のJavaScriptはブラウザには送信されません。一方のClient Componentは、従来のReactと同じようにブラウザ側で実行されるコンポーネントで、ファイル冒頭に "use client" ディレクティブを書いて明示します。

両者の違いを整理すると、以下の通りです。

観点 Server Component(デフォルト) Client Component
実行場所 サーバ ブラウザ
指定方法 何も書かない ファイル冒頭に "use client" と書く
バンドルサイズ 含まれない JavaScriptがブラウザに配信される
データ取得 サーバ側で直接fetchやDBアクセスができる ブラウザからfetchする
useState / useEffect 使えない 使える
ブラウザAPI(window / document) 使えない 使える
イベントハンドラ(onClick など) 付けられない 付けられる

Server Componentのメリットは、ブラウザに配信するJavaScriptを減らせることと、認証情報やDB接続文字列などブラウザに露出させたくない情報をコンポーネント内で直接扱える点にあります。一方のClient Componentは、useState で状態を持ちたい、ボタンにイベントハンドラを付けたい、window などのブラウザAPIを使いたい、といったインタラクティブな要素で必要になります。

「まずServer Componentで書き、インタラクティブな要素だけをClient Componentに切り出す」というのがApp Routerの基本的な進め方です。この章の後半でも、実際にServer Componentでカウンタを作ろうとしてエラーを出し、"use client" を付けて解決する体験をします。