- Day 24:Reactの状態管理を理解する
- 1. State管理を考える前に
- 2. Local State:ひとつの場所で使う状態
- 3. Props Drilling:Propsを何階層も渡す
- 4. Stateの持ち上げ:共通の親で状態を管理する
- 5. Context:離れた子孫へ値を共有する
- 6. テーマ切り替え機能の構成
- 7. Contextを作る
- 8. Providerでテーマを管理する
- 9. Next.jsのレイアウトでProviderを使う
- 10. テーマ切り替えボタンを作る
- 11. テーマプレビューを作る
- 12. ページで部品を配置する
- 13. CSSでライト・ダークテーマを設定する
- 14. 画面上で起きること
- 15. どの方法を選ぶか
- 16. 大切な注意点
- 17. よくあるつまずき
- 18. Day 24のチェックリスト
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>
);
}JSXcountをほかのコンポーネントと共有しないなら、親へ移動させる必要はありません。使う場所の近くで管理するのが、基本の考え方です。
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>
);
}JSXStateを親に置くと、兄弟コンポーネントが同じ値を共有できます。ただし、親から子への階層が深くなると、多くの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;JSXuseThemeは、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>
);
}JSXThemeProviderは、テーマの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>
);
}JSXProviderをレイアウトに置くと、その内側のページや子コンポーネントが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>
);
}JSXaria-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>
);
}JSXThemeToggleと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>
);
}JSX13. 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を目的なく増やさず、状態の共有範囲に合わせて選ぶことが大切です。
