- Day 41:Server ComponentsとClient Componentsを使い分ける
- 1. Server Componentsとは
- 2. Client Componentsとは
- 3. “use client”とは
- 4. 判断に迷ったときの考え方
- 5. 例題:ブログ詳細ページの部品を設計する
- 6. 操作する部品をClient Componentにする
- 7. ページはServer Componentのままにする
- 8. ServerからClientへ渡せる値
- 9. よくある設計ミス
- 10. Client Componentの中にServer Componentを置きたい場合
- 11. 実践:家計簿アプリのコンポーネントを分類する
- 12. セキュリティ上の注意
- 13. Day 41のチェックリスト
- まとめ
Day 41:Server ComponentsとClient Componentsを使い分ける
Day 41では、Next.js App RouterのServer ComponentsとClient Componentsを学び、どの部品をどちらにするか設計します。ポイントは、ページ全体を何となくClient Componentにするのではなく、操作が必要な小さな部品だけをClient Componentにすることです。
App Routerでは、ページやレイアウトは既定でServer Componentsです。表示、サーバー上でのデータ取得、秘密情報を使う処理などはServer Componentにし、State・クリックイベント・ブラウザーAPIが必要な部分にClient Componentを使います。(🔗 nextjs.org)
1. Server Componentsとは
Server Componentは、サーバー側で処理されるReactコンポーネントです。App Routerでは特別な指定をしないコンポーネントが基本的にServer Componentになります。
Server Componentは、次のような部分に向いています。
- 見出しや文章など、表示が中心の部分。
- サーバーからデータを取得して表示する部分。
- データベースや秘密情報を使うサーバー側の処理。
- ブラウザーへ送るJavaScriptをできるだけ増やしたくない部分。
Server ComponentはブラウザーでStateやイベント処理を行う部品ではありません。useStateやuseEffect、onClick、windowなど、ブラウザー側の機能が必要な場合はClient Componentにします。(🔗 nextjs.org)
2. Client Componentsとは
Client Componentは、ブラウザー上で操作できるReactコンポーネントです。Stateを使ったり、ボタンのクリックに応じて表示を変えたりできます。
- 開閉するメニュー。
- 入力フォームや入力値の即時チェック。
- 「いいね」ボタンやタブ切り替え。
- ブラウザーの`localStorage`や`window`を使う機能。
- `useState`や`useEffect`などのHookを使う部分。
大切な注意点があります。Client Componentは、初回表示時に必ずブラウザーだけで描画されるわけではありません。Next.jsは初回表示用のHTMLをサーバーで生成し、その後ブラウザー側でJavaScriptを読み込んで操作できる状態にします。この処理をハイドレーションと呼びます。(🔗 nextjs.org)
3. “use client”とは
"use client"は、このファイルをClient Componentの入口として扱うための指定です。ファイルの先頭、import文より前に書きます。
// このファイルをClient Componentの入口にします
"use client";
// この下でReact Hookなどを読み込みます
import { useState } from "react";TSX"use client"は、書いたファイルだけでなく、そのファイルからimportされるモジュールにも影響します。つまり、大きなページ全体に付けると、そのページから読み込む多くの部品もクライアント側のJavaScriptに含まれることがあります。必要な部品の境界にだけ付けるのが基本です。(🔗 nextjs.org)
4. 判断に迷ったときの考え方
次の質問を順番に確認すると、どちらにするか考えやすくなります。
- クリックや入力に応じて表示が変わりますか。必要ならClient Componentを検討します。
- `useState`、`useEffect`などを使いますか。使うならClient Componentです。
- `window`や`localStorage`など、ブラウザーだけにある機能を使いますか。使うならClient Componentです。
- 文章やデータを表示するだけですか。まずServer Componentにします。
- サーバー側でデータを取得したいですか。Server Componentにするのが自然です。
迷ったらServer Componentから始め、インタラクションが必要になった部品だけをClient Componentにします。公式ドキュメントでも、ServerとClientを組み合わせて使い、Client Componentの範囲を適切に限定する方法が説明されています。(🔗 nextjs.org)
5. 例題:ブログ詳細ページの部品を設計する
ブログ詳細ページを例に考えます。
- 記事タイトルと本文:表示が中心なのでServer Component。
- 記事データの取得:サーバーから取得するならServer Component。
- 「いいね」ボタン:クリックで数字が変わるためClient Component。
ファイルは次のように分けます。
src/
├── app/
│ └── blog/
│ └── [id]/
│ └── page.tsx
└── components/
└── LikeButton.tsx
ページとボタンを分けることで、記事本文までClient Componentにする必要がなくなります。
6. 操作する部品をClient Componentにする
src/components/LikeButton.tsxを作ります。ボタンを押すと「いいね」の数が増えるため、この部品をClient Componentにします。
// このファイルをClient Componentの入口にします
"use client";
// クリック後の数を管理するStateを読み込みます
import { useState } from "react";
// いいねボタンのPropsです
type LikeButtonProps = {
initialLikes: number;
};
// クリックするといいね数が増える部品です
export default function LikeButton({
initialLikes,
}: LikeButtonProps) {
// いいね数をブラウザー側で管理します
const [likes, setLikes] = useState(initialLikes);
return (
<button
type="button"
// クリック時に現在の値から1増やします
onClick={() => setLikes((currentLikes) => currentLikes + 1)}
>
いいね:{likes}
</button>
);
}TSXuseStateとonClickを使っているため、この部品には"use client"が必要です。逆に、表示だけの見出しや本文までClient Componentにする必要はありません。
7. ページはServer Componentのままにする
src/app/blog/[id]/page.tsxは記事を表示するだけなので、"use client"を付けずServer Componentのままにします。
// クリックできるClient Componentを読み込みます
import LikeButton from "../../../components/LikeButton";
// 学習用の記事データです
const posts = [
{
id: "1",
title: "Server Componentsを学ぶ",
body: "表示中心の部品と、操作する部品を分けて考えます。",
likes: 3,
},
{
id: "2",
title: "Client Componentsを学ぶ",
body: "Stateやクリックイベントが必要な部分をClient Componentにします。",
likes: 5,
},
];
// 現在のNext.js App Routerのparamsを受け取る型です
type BlogPageProps = {
params: Promise<{
id: string;
}>;
};
// ブログ詳細ページです。ここには"use client"を付けません
export default async function BlogPage({ params }: BlogPageProps) {
// URLから記事IDを取得します
const { id } = await params;
// IDが一致する記事を探します
const post = posts.find((item) => item.id === id);
// 記事が見つからない場合の表示です
if (!post) {
return (
<main>
<h1>記事が見つかりません</h1>
</main>
);
}
return (
<main>
{/* 記事本文は表示中心なのでServer Component側で出力します */}
<article>
<h1>{post.title}</h1>
<p>{post.body}</p>
</article>
{/* 操作が必要な部分だけClient Componentにします */}
<LikeButton initialLikes={post.likes} />
</main>
);
}TSXこのページは、記事を探して表示する部分をServer Componentとして保ち、クリックが必要なLikeButtonだけをClient Componentにしています。Server ComponentからClient Componentを読み込んで組み合わせることができます。(🔗 nextjs.org)
8. ServerからClientへ渡せる値
Server ComponentからClient ComponentへPropsを渡すときは、Reactが受け渡しできる形式である必要があります。数値、文字列、配列、プレーンなオブジェクトなどは代表例です。
上の例では、initialLikesという数値を渡しています。
// 数値をClient Componentへ渡しています
<LikeButton initialLikes={post.likes} />TSX一方、普通の関数をServer ComponentからClient ComponentへPropsとして渡すことはできません。ServerとClientの境界をまたぐPropsには、シリアライズ可能な値を使います。(🔗 nextjs.org)
9. よくある設計ミス
- ページ全体に`”use client”`を付ける:操作しない表示部分までクライアント側のモジュールに入り、ブラウザーへ送るJavaScriptが増えることがあります。
- `useState`をServer Componentで使おうとする:Stateが必要な部分を小さなClient Componentに分けます。
- `”use client”`をすべてのファイルに付ける:Client Componentの入口にだけ指定すればよく、その子のファイルすべてに書く必要はありません。
- 秘密情報をClient Componentへ渡す:Client ComponentのコードやPropsはブラウザーから確認できる前提で考えます。
- Client Componentなら初回も必ずブラウザーだけで描画されると思う:初回表示ではサーバー側でHTMLが生成され、その後にブラウザーでハイドレーションされます。
特に重要なのは、Client Componentのファイルからimportされるコードもクライアント側の依存に含まれ得る点です。サーバー専用のデータベース接続や秘密鍵を、Client Componentから参照する構成にしないでください。(🔗 nextjs.org)
10. Client Componentの中にServer Componentを置きたい場合
「外側に操作部品があるけれど、中身はServer Componentにしたい」という場面もあります。そのときは、Server ComponentをClient Componentのファイルから直接importするのではなく、親のServer ComponentからchildrenなどのPropsとして渡す構成が使えます。Next.js公式も、Server ComponentをClient Componentのchildrenや別のPropsとして渡す組み合わせ方を説明しています。(🔗 nextjs.org)
概念を示す例です。
<em>// Client Componentの例です</em>
"use client";
<em>// 子の表示を受け取るPropsです</em>
type PanelProps = {
children: React.ReactNode;
};
<em>// 開閉状態を持つパネルです</em>
export default function Panel({ children }: PanelProps) {
<em>// パネルの開閉状態を管理します</em>
const [isOpen, setIsOpen] = useState(true);
return (
<section>
<button
type="button"
// 表示状態を切り替えます
onClick={() => setIsOpen((current) => !current)}
>
{isOpen ? "閉じる" : "開く"}
</button>
{/* 親から渡された表示内容を配置します */}
{isOpen && children}
</section>
);
}TSXこの例でuseStateを使うには、ReactからuseStateをimportしてください。親のServer Componentが作った表示内容をPanelのchildrenとして渡せば、Client Component側にサーバー専用の表示ロジックを直接importせずに組み合わせられます。(🔗 nextjs.org)
11. 実践:家計簿アプリのコンポーネントを分類する
Day 33〜35で作った家計簿アプリを題材に、どの部品をServer・Clientのどちらにするか考えます。LocalStorageを使うアプリなので、ブラウザー側で動く必要がある部品があります。
| 部品・処理 | 分類の目安 | 理由 |
|---|---|---|
| 静的な説明や見出し | Server | 表示中心です |
| サーバーから取得する記事・商品情報 | Server | サーバーでデータを取得できます |
| 取引フォーム | Client | 入力Stateや送信イベントを使います |
| 月選択・フィルター | Client | 操作に応じて表示が変わります |
| LocalStorageの読み書き | Client側の処理 | ブラウザーAPIを使います |
| グラフの操作・凡例切り替え | ライブラリに応じて判断 | ブラウザー側の機能が必要な場合があります |
この分類は「ページ全部をClientにするかServerにするか」だけで考えず、機能を小さな部品に分け、それぞれに必要な実行環境を判断するのがコツです。
12. セキュリティ上の注意
Server Componentを使えば、秘密情報が自動的に安全になるわけではありません。Client Componentへ渡した値や画面に表示した値は、利用者から見える可能性があります。
- 秘密鍵やデータベース接続情報をClient Componentに書かないでください。
- サーバーで取得したデータのうち、ブラウザーへ渡してよいものだけをPropsに含めます。
- Client Componentから送られる値は信用せず、重要な操作はサーバー側でも検証します。
「Server Componentだから安全」と一括りにするのではなく、どの値がブラウザーへ渡るかを確認することが大切です。
13. Day 41のチェックリスト
- Server Componentが、表示やサーバー側データ取得に向いていると説明できます。
- Client Componentが、State・イベント・ブラウザーAPIに必要だと説明できます。
- `”use client”`をファイル先頭に置き、Client Componentの境界を作れます。
- クリックなどが必要な部品だけをClient Componentにできます。
- ServerからClientへ渡すPropsの値を慎重に選べます。
- Client ComponentのコードやPropsはブラウザーから見える可能性があると理解しています。
- ページ全体を安易にClient Componentにしない設計ができます。
まとめ
Day 41では、Server ComponentsとClient Componentsの役割を学びました。基本は、表示中心のページやサーバーで扱うデータをServer Componentにし、State・イベント・ブラウザーAPIが必要な部分だけをClient Componentにすることです。
ブログ詳細ページの例では、記事本文はServer Componentのままにし、クリックで数字が変わる「いいね」ボタンだけをClient Componentにしました。このように境界を小さく保つと、どのコードがブラウザーへ届くか分かりやすくなり、構成と性能の両面で管理しやすくなります。
