Server ComponentとClient Componentの使い分け

「Next.jsの概要」で説明した通り、App RouterではすべてのコンポーネントがデフォルトでServer Componentとして扱われます。ここでは実際にカウンタコンポーネントを作ってServer Componentのままではエラーになることを体験し、"use client" を付けてClient Componentに切り替えることで動くようになる流れを確認します。

1. Server Componentでのカウンタ実装(エラーの体験)

前章の Reactの基本 で扱った useState を使ったカウンタを、App Routerのページとして作ってみます。Reactの基本章で書いたカウンタと本質的には同じコードですが、Server Component のまま("use client" を付けずに)書くとどうなるかを確認するのがここの目的です。

Visual Studio Codeのエクスプローラーで app フォルダを右クリックし、「新しいフォルダー」から counter フォルダを作成します。作成した counter フォルダを右クリックして、「新しいファイル」から page.tsx を作成します。

my-next-app/
├── app/
│   ├── about/
│   │   └── page.tsx
│   ├── counter/
│   │   └── page.tsx  ← このファイルを作成
│   ├── products/
│   │   └── [id]/
│   │       └── page.tsx
│   ├── favicon.ico
│   ├── globals.css
│   ├── layout.tsx
│   ├── page.module.css
│   └── page.tsx
├── public/
├── next.config.ts
├── package.json
└── tsconfig.json

作成した app/counter/page.tsx に、Server Componentのまま("use client" を書かずに)以下の内容を記述して保存します。

import { useState } from "react";

export default function CounterPage() {
  const [count, setCount] = useState(0);

  return (
    <div>
      <h1>カウンタ</h1>
      <p>現在の値: {count}</p>
      <button onClick={() => setCount(count + 1)}>+1する</button>
    </div>
  );
}

保存できたら、ブラウザで http://localhost:3000/counter を開いてみます。以下のようなエラーがブラウザとターミナルの両方に表示されます。

You're importing a module that depends on `useState` into a React Server Component module. This API is only available in Client Components. To fix, mark the file (or its parent) with the `"use client"` directive.

これはApp RouterがこのファイルをServer Componentとして解釈しようとした結果、サーバ側では動かせない useState が使われていることを検知して出しているエラーです。同様に、onClick のようなイベントハンドラや、useEffect などのReact Hooks、window document などのブラウザAPIも、Server Componentでは扱えません。

"use client" によるClient Componentへの切り替え

エラーで表示された通り、このコンポーネントはブラウザ側で動く必要があるため、Client Componentに切り替える必要があります。App Routerでは、ファイルの一番上に "use client" と書くだけでClient Componentになります。書き方は以下のとおりです。

"use client";

import 〜;

// コンポーネント定義

以下は、先ほどのカウンタコンポーネントに "use client" を追加した例です。app/counter/page.tsx を、以下の内容に置き換えます。

"use client";

import { useState } from "react";

export default function CounterPage() {
  const [count, setCount] = useState(0);

  return (
    <div>
      <h1>カウンタ</h1>
      <p>現在の値: {count}</p>
      <button onClick={() => setCount(count + 1)}>+1する</button>
    </div>
  );
}

保存できたら、ブラウザで http://localhost:3000/counter をリロードします。エラーが消えてカウンタが表示され、「+1する」ボタンを押すたびに数字が増えていけば、Client Componentへの切り替えは成功です。

コードを解説します。

"use client";

追加したのはファイル冒頭の1行だけです。この "use client" ディレクティブがそのファイル以下をClient Componentとして扱う目印になります。ファイルの先頭に書く必要があり、import 文よりも上に置きます。

💡 ポイント
"use client" はファイル単位で有効です。1つのページの中でも、動的な要素だけを別ファイルの小さなClient Componentに切り出し、それ以外はServer Componentのまま残す構成が推奨されます。すべてを "use client" にすると、Server Componentのメリット(バンドルサイズ削減・サーバでの直接データ取得)が失われるため、Client Componentは必要な箇所に限定します。詳しい使い分けの考え方はServer and Client Components(Next.js公式ドキュメント)に記載があります。