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" を付けて解決する体験をします。