Next.jsで学ぶReact講座 90日コース | React基礎 - Day 24:Reactの状態管理を理解する

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

Day 24:Reactの状態管理を理解する

Reactの状態管理では、「データをどのコンポーネントが持つか」と「そのデータを必要なコンポーネントへどう渡すか」を考えます。この日は、useStateによるLocal State、Props Drilling、Stateの持ち上げ、Contextを順に学び、最後にテーマ切り替え機能を作ります。

1. State管理を考える前に

State(状態)は、操作によって変化し、画面表示に使われるデータです。たとえば、現在のテーマがライトかダークか、メニューが開いているかどうかなどがStateです。

状態管理で最初に考えるのは、次の点です。

  • どのコンポーネントがそのデータを使うのか。
  • そのデータを変更する操作はどこにあるのか。
  • 複数のコンポーネントが同じデータを必要としているのか。

必要な場所より広い範囲でStateを管理すると、関係のないコンポーネントまで複雑になることがあります。まずは、状態を使う範囲に合わせて置く場所を決めましょう。

2. Local State:ひとつの場所で使う状態

Local Stateは、主にひとつのコンポーネント内だけで使う状態です。たとえば、カウンターの数値をカウンターコンポーネントだけが使うなら、そのコンポーネントで管理します。

// Reactの状態管理機能を読み込みます
import { useState } from "react";

// カウンターの状態を自分で管理するコンポーネントです
function Counter() {
  // このコンポーネント内で使う数値を管理します
  const [count, setCount] = useState(0);

  return (
    <section>
      <p>現在の値:{count}</p>

      {/* 押すと現在の値を1増やします */}
      <button
        type="button"
        onClick={() => setCount((currentCount) => currentCount + 1)}
      >
        1増やす
      </button>
    </section>
  );
}
JSX

countをほかのコンポーネントと共有しないなら、親へ移動させる必要はありません。使う場所の近くで管理するのが、基本の考え方です。

3. Props Drilling:Propsを何階層も渡す

ある状態を深い階層のコンポーネントで使いたいとき、親から子へPropsを順に渡していくことがあります。中間のコンポーネント自身は値を使わないのに、さらに下の子へ渡すためだけにPropsを受け取る状態を、**Props Drilling(プロップス・ドリリング)**と呼びます。

// 最上位のコンポーネントがテーマと変更関数を持つ例です
function App() {
  const [theme, setTheme] = useState("light");

  return (
    // ToolbarへPropsを渡します
    <Toolbar theme={theme} onToggleTheme={() => {
      setTheme((currentTheme) =>
        currentTheme === "light" ? "dark" : "light"
      );
    }} />
  );
}

// Toolbarは自分ではテーマを使わず、さらに下へ渡します
function Toolbar({ theme, onToggleTheme }) {
  return (
    // ThemeButtonへPropsを受け渡します
    <ThemeButton theme={theme} onToggleTheme={onToggleTheme} />
  );
}

// ThemeButtonがテーマを使って表示を切り替えます
function ThemeButton({ theme, onToggleTheme }) {
  return (
    <button type="button" onClick={onToggleTheme}>
      現在のテーマ:{theme}
    </button>
  );
}
JSX

階層が浅ければPropsで渡す方法は分かりやすく、問題ありません。しかし、中間コンポーネントが多くなり、値を使わないコンポーネントまで受け渡しに関わると、変更時に修正箇所が増えて分かりにくくなります。

Props Drillingが少しあるだけでContextが必要になるわけではありません。Propsの流れが明確で、構造も複雑でなければ、Propsを使い続けるほうが簡潔なこともあります。

4. Stateの持ち上げ:共通の親で状態を管理する

兄弟コンポーネントが同じ状態を使う場合は、その共通の親へStateを移動する方法があります。これをStateの持ち上げ(Lifting State Up)と呼びます。

たとえば、テーマ切り替えボタンとプレビュー表示が同じテーマを使うなら、親がテーマを管理し、両方の子へPropsで渡します。

// 2つの子コンポーネントで共有する状態を親に置きます
function ThemePage() {
  // 共通の親がテーマを管理します
  const [theme, setTheme] = useState("light");

  // テーマを反対の値に切り替える関数です
  function toggleTheme() {
    setTheme((currentTheme) =>
      currentTheme === "light" ? "dark" : "light"
    );
  }

  return (
    <main>
      {/* ボタンとプレビューの両方へ同じテーマを渡します */}
      <ThemeToggle theme={theme} onToggle={toggleTheme} />
      <ThemePreview theme={theme} />
    </main>
  );
}
JSX

Stateを親に置くと、兄弟コンポーネントが同じ値を共有できます。ただし、親から子への階層が深くなると、多くのPropsを受け渡すことになります。

5. Context:離れた子孫へ値を共有する

Contextは、親から深い階層にあるコンポーネントへ値を提供する仕組みです。Contextを使うと、中間コンポーネントを経由してPropsを渡し続けなくても、Providerの内側にある子孫が値を読み取れます。

  • createContext:共有する値のためのContextを作ります。
  • Provider:Contextの値を子孫へ提供します。
  • useContext:子孫コンポーネントで値を読み取ります。

Contextは状態そのものを作る仕組みではありません。useStateなどで管理している値を、離れたコンポーネントから使いやすくする仕組みです。

6. テーマ切り替え機能の構成

今回は、テーマのStateをProviderで管理し、テーマ切り替えボタンとプレビューで共有します。

my-app/
├── app/
│   ├── globals.css
│   ├── layout.js
│   └── page.js
└── components/
    └── theme/
        ├── ThemeContext.js
        ├── ThemeProvider.js
        ├── ThemeToggle.js
        └── ThemePreview.js

App Routerのlayout.jsはサーバー側のコンポーネントのままにし、Context ProviderだけをClient Componentにします。クリック操作やuseState、useContextを使うファイルには'use client'を記述します。

7. Contextを作る

components/theme/ThemeContext.jsを作成します。

// このファイルでContextを作るためClient Componentにします
"use client";

// ReactからContext作成と利用機能を読み込みます
import { createContext, useContext } from "react";

// 初期値としてnullを設定したThemeContextを作ります
const ThemeContext = createContext(null);

// 子孫コンポーネントがテーマを読み取るためのHookです
export function useTheme() {
  // 最も近いThemeContext.Providerの値を読み取ります
  const context = useContext(ThemeContext);

  // Providerの外で使った場合に分かりやすいエラーを出します
  if (context === null) {
    throw new Error("useThemeはThemeProviderの内側で使ってください。");
  }

  // テーマと切り替え関数を呼び出し元へ返します
  return context;
}

// ProviderからContextを使えるようにエクスポートします
export default ThemeContext;
JSX

useThemeは、useContext(ThemeContext)を各コンポーネントに何度も書かずに済むようにするカスタムHookです。またProviderの外で使った場合、原因が分かりやすいエラーを表示します。

8. Providerでテーマを管理する

components/theme/ThemeProvider.jsを作ります。ここでStateを管理し、Contextの値を子孫へ提供します。

// このファイルをClient Componentとして扱います
"use client";

// Reactの状態管理機能を読み込みます
import { useState } from "react";

// 作成したThemeContextを読み込みます
import ThemeContext from "./ThemeContext.js";

// テーマ状態を管理し、子孫に提供するコンポーネントです
export default function ThemeProvider({ children }) {
  // 最初はライトテーマにします
  const [theme, setTheme] = useState("light");

  // 現在のテーマを反対のテーマに切り替えます
  function toggleTheme() {
    setTheme((currentTheme) =>
      currentTheme === "light" ? "dark" : "light"
    );
  }

  // テーマと操作関数を子孫に提供します
  const contextValue = {
    theme,
    toggleTheme,
  };

  return (
    // Providerの内側にあるコンポーネントからContextを使えます
    <ThemeContext.Provider value={contextValue}>
      {/* テーマに応じたclassNameを付ける外枠です */}
      <div className={`theme-shell theme-${theme}`}>
        {children}
      </div>
    </ThemeContext.Provider>
  );
}
JSX

ThemeProviderは、テーマのStateと切り替え処理を管理します。ThemeContext.Providerの内側にあるコンポーネントは、useTheme()で同じ値を取得できます。

9. Next.jsのレイアウトでProviderを使う

app/layout.jsにProviderを配置します。layout.js自体には'use client'を付けず、ProviderだけをClient Componentとして使います。

// グローバルCSSを読み込みます
import "./globals.css";

// Client ComponentのThemeProviderを読み込みます
import ThemeProvider from "../components/theme/ThemeProvider.js";

// アプリ全体の共通レイアウトです
export default function RootLayout({ children }) {
  return (
    <html lang="ja">
      <body>
        {/* ページをProviderで包み、テーマを共有します */}
        <ThemeProvider>{children}</ThemeProvider>
      </body>
    </html>
  );
}
JSX

Providerをレイアウトに置くと、その内側のページや子コンポーネントがContextを利用できます。Providerをページ単位に置けば、そのページの範囲だけで共有できます。使う場所に合わせてProviderの範囲を決めましょう。

10. テーマ切り替えボタンを作る

components/theme/ThemeToggle.jsを作成します。ボタン自身はテーマ状態を持たず、Contextから現在のテーマと切り替え関数を取得します。

// このファイルをClient Componentとして扱います
"use client";

// 作成したテーマ用Hookを読み込みます
import { useTheme } from "./ThemeContext.js";

// テーマを切り替えるボタンです
export default function ThemeToggle() {
  // Contextから現在のテーマと切り替え関数を取得します
  const { theme, toggleTheme } = useTheme();

  return (
    <button
      type="button"
      onClick={toggleTheme}
      aria-pressed={theme === "dark"}
    >
      {/* 現在のテーマに応じてボタンの説明を変えます */}
      {theme === "dark" ? "ライトテーマにする" : "ダークテーマにする"}
    </button>
  );
}
JSX

aria-pressedは、このボタンがオン・オフの状態を切り替えるボタンであることを支援技術に伝えます。表示文字だけでなく、現在の状態も伝えるようにします。

11. テーマプレビューを作る

components/theme/ThemePreview.jsを作成します。ボタンとは別のコンポーネントから、同じContextを読み取ります。

// このファイルをClient Componentとして扱います
"use client";

// テーマ用Hookを読み込みます
import { useTheme } from "./ThemeContext.js";

// 現在のテーマを表示するコンポーネントです
export default function ThemePreview() {
  // Contextからテーマを取得します
  const { theme } = useTheme();

  return (
    <section className="theme-preview">
      <h2>プレビュー</h2>
      <p>現在のテーマは「{theme}」です。</p>
      <p>ボタンを押すと、この表示と背景色が切り替わります。</p>
    </section>
  );
}
JSX

ThemeToggleとThemePreviewは兄弟コンポーネントですが、どちらも同じProviderからテーマを読み取ります。Propsを何階層も渡す必要はありません。

12. ページで部品を配置する

app/page.jsでは、部品を配置します。このファイル自体は状態やイベントを扱わないため、サーバー側のコンポーネントのままで構いません。

// テーマ切り替えボタンを読み込みます
import ThemeToggle from "../components/theme/ThemeToggle.js";

// テーマプレビューを読み込みます
import ThemePreview from "../components/theme/ThemePreview.js";

// トップページを表示します
export default function HomePage() {
  return (
    <main className="page-content">
      <h1>テーマ切り替え</h1>
      <p>Contextを使って、離れたコンポーネントでテーマを共有します。</p>

      {/* Contextの値を変更するボタンです */}
      <ThemeToggle />

      {/* 同じContextの値を表示するコンポーネントです */}
      <ThemePreview />
    </main>
  );
}
JSX

13. CSSでライト・ダークテーマを設定する

app/globals.cssにスタイルを追加します。Providerの外枠につけたtheme-light、theme-darkというクラスで背景色や文字色を切り替えます。

/* ページの基本設定です */
* {
  box-sizing: border-box;
}

body {
  margin: 0;
  font-family: sans-serif;
}

/* Providerが付けるテーマ用の外枠です */
.theme-shell {
  min-height: 100vh;
  transition: background-color 0.2s ease, color 0.2s ease;
}

/* ライトテーマの色です */
.theme-light {
  color: #202124;
  background-color: #ffffff;
}

/* ダークテーマの色です */
.theme-dark {
  color: #f5f5f5;
  background-color: #202124;
}

/* ページ本文の幅と余白を設定します */
.page-content {
  max-width: 720px;
  margin: 0 auto;
  padding: 32px 20px;
}

/* プレビュー部分を枠で囲みます */
.theme-preview {
  margin-top: 24px;
  padding: 20px;
  border: 1px solid currentColor;
  border-radius: 8px;
}

/* ボタンの押しやすさを確保します */
button {
  padding: 10px 16px;
  cursor: pointer;
}

14. 画面上で起きること

完成後、ボタンを押すと次の流れで動きます。

  • `ThemeToggle`がContextから`toggleTheme`を取得します。
  • クリックすると`toggleTheme`が実行されます。
  • `ThemeProvider`が`theme`のStateを更新します。
  • Providerの子孫が新しいContextの値を受け取ります。
  • ボタンの文字、プレビューのテーマ名、背景色が変わります。

15. どの方法を選ぶか

状態をどこに置くか、どの方法で渡すかは、共有する範囲で決めます。

状況まず検討する方法
ひとつのコンポーネントだけで使うLocal State
近くの子や兄弟コンポーネントで使うProps、またはStateの持ち上げ
深い子孫の複数箇所で使うContext
状態の更新ルールが複雑になってきたContextとuseReducerなどを検討

Contextは便利ですが、何でもContextに入れる必要はありません。たとえば、ひとつの入力欄だけで使う値をアプリ全体のContextにすると、構造が必要以上に複雑になります。

16. 大切な注意点

  • ContextはProviderの範囲で有効です。Providerの外側にあるコンポーネントから、その値は読み取れません。
  • Providerを複数置くと、近いProviderの値が使われます。意図しない場所でProviderを重ねていないか確認します。
  • Contextは値を配る仕組みで、状態管理そのものを置き換えるものではありません。状態を変更する処理は`useState`などで作ります。
  • Contextの値が変わると、そのContextを使うコンポーネントが更新されます。大きな範囲へ大量の値をひとまとめにすると、不要な再レンダーの原因になる場合があります。
  • テーマを再読み込み後も保存する機能は、この例にはありません。`localStorage`などで保存する場合は、サーバー描画とブラウザー描画の違いによる表示のずれにも配慮が必要です。

テーマの保存は発展課題です。まずはProviderから値を共有し、複数コンポーネントで同じStateを使えることを確認しましょう。

17. よくあるつまずき

  • `useTheme`がエラーになる:利用しているコンポーネントが`ThemeProvider`の内側にあるか確認します。
  • テーマが切り替わらない:ボタンがContextの`toggleTheme`を呼び出しているか、ProviderでStateを更新しているか確認します。
  • 画面全体の色が変わらない:Providerの外枠にテーマ用クラスが付いているか、CSSのクラス名が一致しているか確認します。
  • PropsがなくなったのでContextにした:階層が浅いならPropsのほうが分かりやすいことがあります。Contextは共有範囲と受け渡しの複雑さを見て判断します。
  • Client Componentのエラーが出る:`useState`や`useContext`、イベント処理を使うファイルの先頭に`’use client’`があるか確認します。

18. Day 24のチェックリスト

  • Local Stateが、主にひとつの場所で使う状態だと説明できます。
  • Props Drillingが、値を使わない中間コンポーネントも含めてPropsを受け渡す状態だと説明できます。
  • 兄弟コンポーネントで共有するStateを共通の親へ移動できます。
  • ContextでProviderの内側に値を共有できます。
  • `useContext`でContextの値を読み取れます。
  • Stateの共有範囲に応じて、Local State、Props、Contextを選べます。
  • ContextのProvider範囲と、値の変更による更新範囲を意識できます。

状態管理では、まずStateを使う範囲を見極めます。ひとつのコンポーネントで使うならLocal State、近い子へ渡すならProps、複数の深い子孫で共有したいならContextが候補です。今回のテーマ切り替えでは、Providerでテーマを管理し、ボタンとプレビューの両方から同じ値を使いました。 Contextを目的なく増やさず、状態の共有範囲に合わせて選ぶことが大切です。

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