Next.jsで学ぶReact講座 90日コース | Next.js基礎 - Day 41:Server Components

React Next.jsで学ぶReact講座90日コース
スポンサーリンク
スポンサーリンク

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>
  );
}
TSX

useStateと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にしました。このように境界を小さく保つと、どのコードがブラウザーへ届くか分かりやすくなり、構成と性能の両面で管理しやすくなります。

タイトルとURLをコピーしました