Contextは便利ですが、入れると全部が再描画されます。なぜそうなるのかを確かめ、分割して影響範囲を狭めます。
これは深掘りです。本線の順路ではありません。 本線のコンポーネントとpropsの回まで終わった人が、「同じ値を下まで渡すのに、途中のコンポーネント全部に props を書くのが嫌になった」ところで読む記事です。飛ばしても本線は進みます。
この記事のコマンドは、すべて VM の中(Ubuntu Server)で打ちます。 Windows の PowerShell ではありません。 画面の確認は、ホストの Windows のブラウザで行います。 本線で作った
~/react-demo/には触りません。 この記事では、まっさらな~/reactlab/を新しく作ります。ポートは 5179 を使います。
ログイン中のユーザー名を、画面の右下の小さなバッジに出したいだけでした。
値を持っているのは一番上の App です。バッジは、そこから5つ下にあります。間にいるコンポーネントは、その値を1つも使いません。 それでも、こう書くことになりました。
<Page user={user} />
<Sidebar user={user} />
<Menu user={user} />
<Profile user={user} />
<NameTag user={user} />
間の4つは、ただ受け取って、そのまま下に渡しているだけです。 これをバケツリレー(prop drilling)と言います。
嫌になるのは、書くのが面倒だからではありません。壊れやすいからです。
- ユーザー名の隣に言語設定も出したくなった → 同じ4箇所に、もう1本追加する
Menuを別の場所でも使いたくなった → 使いもしないuserを渡さないと動かないProfileでuserをusrと書き間違えた → エラーは出ず、一番下だけundefinedになる
そこで React には、途中を飛ばして値を配る仕組みがあります。Context です。
ただし、代償があります。 これを入れた直後、私の画面はこうなりました。
ユーザー名とも言語とも関係ない、ただのカウンターのボタンを押しただけで、Context を読んでいるコンポーネントが全部再描画されるようになった。
バケツリレーは消えました。代わりに、目に見えない再描画が増えました。この記事は、その代償を再描画の回数で数えて、払える形まで持っていくまでをやります。
そして先に、この記事の結論を書きます。
Context を入れる前に、
childrenで消せないかを必ず試す。 Context は「配る仕組み」であって、「更新を賢くする仕組み」ではない。
対象レベル: 中級〜上級 / 区分: 発展
この記事でわかること
- バケツリレーの多くは、Context ではなく
childrenで消せること。構造の問題を、道具で殴る前に構造で直す - Provider で囲み忘れても、エラーにならず既定値が静かに使われること。画面は動いてしまうので、誰も気付けない
value={{ a, b }}と書くと、aもbも変わっていないのに毎回「別の値」になること。関係ないボタン1つで、読んでいる全員が再描画されるuseMemoで安定させても、まだ足りないこと。aだけ変えたのに、bしか使っていない側も再描画される- Context は「1つの大きな箱」にしないこと。変わるタイミングが違う値は、別の Context に分ける
- 状態と更新関数を分けると、「書くだけの部品」は二度と再描画されなくなること
- Context は状態管理ライブラリではないこと。配達はするが、誰に配らないかは判断しない
この記事でやること
~/reactlab/を新しく作り、ポート 5179 で起動する- 5階層のバケツリレーを実際に書き、それを
childrenで消す createContext/Provider/useContextで Context を入れ、囲み忘れをカスタムフックのthrowで潰す- 関係ないボタンで全員が再描画されるのを数え、
useMemoと Context の分割で減らす - 状態と更新関数を別の Context に分け、「書くだけの部品」の再描画が止まることを実測する
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| バケツリレー(prop drilling) | 途中のコンポーネントが、使いもしない値を受け取って下に渡し続けること |
| Context | ツリーの途中を飛ばして、下にいる誰にでも値を届けるReact の仕組み |
createContext | Context を1つ作る関数。返ってくるのは「箱」ではなく、Provider を持ったオブジェクト |
| Provider | 「ここから下の全員に、この値を配る」と宣言するコンポーネント。 <Ctx.Provider value={...}> |
useContext | 一番近い上の Provider から、値を受け取るフック。受け取る=購読するという意味になる |
| 既定値(default value) | createContext(既定値) に書いた値。Provider に囲まれていないときにだけ使われる |
| 購読(subscribe) | 値が変わったら教えてもらう約束をすること。 useContext した時点で、自動的にこの約束が結ばれる |
| 横断的な関心事 | テーマ・言語・ログイン情報のように、画面のどこからでも参照される種類の値 |
再描画(re-render)と参照の比較(Object.is)は、再描画の回を数える記事で扱っています。 この記事では、そこで作った数え方をそのまま使います。
① 練習場を作る
本線で作った ~/react-demo/ は触りません。 壊しながら試すので、別のプロジェクトを1つ作ります。
VMの中で実行します。
確認: ls src で App.jsx と main.jsx が出れば成功です。
App.css App.jsx assets index.css main.jsx
ポートを開けます。この記事では 5179 を使います。(他の深掘り記事の練習場と同時に動かしても、ぶつからないようにするためです)
確認: 一覧に 5179/tcp ALLOW が出ていれば成功です。
起動します。
--host 0.0.0.0 が要る理由は、これが無いと VM の中からしか繋がらないからです(ネットワークの回)。VM の IP は ip a で調べます。
ホストの Windows のブラウザで http://<VMのIP>:5179/ を開いて、Vite のロゴが出れば準備完了です。
以降ずっと
npm run devを動かしたままにします。 保存するたびにブラウザが自動で更新されます。止めるのはCtrl + C、再開は同じコマンドです。
数えるために、StrictMode を外す
この記事は「何回再描画されたか」を数え続けます。 StrictMode が付いていると、開発中は関数がわざと2回呼ばれるので(再描画の回で扱いました)、数字が全部2倍になって読みにくくなります。
この記事の間だけ外します。src/main.jsx を、こう書き換えます。
import { createRoot } from 'react-dom/client'
import './index.css'
import App from './App.jsx'
createRoot(document.getElementById('root')).render(<App />)
本番のコードで外してはいけません。
StrictModeは危ない書き方を見つけるための仕組みです。外すのは「数を数える実験のときだけ」で、この記事の最後(後片づけ)で戻します。
② まず「本当に Context が要るか」を疑う
ここを飛ばして Context を入れると、後で必ず後悔します。 先に、バケツリレーを道具なしで消せないかを確かめます。
5階層のバケツリレーを、実際に書く
まず、嫌になったコードを再現します。 6つのファイルを作ります。
src/App.jsx
import { useState } from 'react'
import Page from './Page'
export default function App() {
const [user, setUser] = useState({ name: 'koki' })
return (
<div style={{ padding: 16, fontFamily: 'sans-serif' }}>
<h1>reactlab</h1>
<button onClick={() => setUser({ name: user.name === 'koki' ? 'guest' : 'koki' })}>
名前を切り替える
</button>
<Page user={user} />
</div>
)
}
src/Page.jsx
import Sidebar from './Sidebar'
export default function Page({ user }) {
return (
<div style={{ border: '1px solid #ccc', padding: 12, marginTop: 12 }}>
<p>Page(user を使っていない)</p>
<Sidebar user={user} />
</div>
)
}
src/Sidebar.jsx
import Menu from './Menu'
export default function Sidebar({ user }) {
return (
<div style={{ border: '1px solid #ccc', padding: 12 }}>
<p>Sidebar(user を使っていない)</p>
<Menu user={user} />
</div>
)
}
src/Menu.jsx
import Profile from './Profile'
export default function Menu({ user }) {
return (
<div style={{ border: '1px solid #ccc', padding: 12 }}>
<p>Menu(user を使っていない)</p>
<Profile user={user} />
</div>
)
}
src/Profile.jsx
import NameTag from './NameTag'
export default function Profile({ user }) {
return (
<div style={{ border: '1px solid #ccc', padding: 12 }}>
<p>Profile(user を使っていない)</p>
<NameTag user={user} />
</div>
)
}
src/NameTag.jsx
export default function NameTag({ user }) {
return <strong>ようこそ {user.name} さん</strong>
}
確認: ブラウザに枠が5重に出て、一番内側に ようこそ koki さん と出ていれば成功です。ボタンを押すと guest に変わります。
[スクリーンショット: 01_バケツリレー.png] 5重の枠の一番内側に「ようこそ koki さん」が出ている画面を撮ってください。
ここで数えます。 user という単語が出てくる場所は、App と NameTag の2箇所で足りるはずなのに、実際には6ファイル中6ファイルに出てきます。
この「使っていないのに書かなければならない」4箇所が、消したいものです。
children で消してみる
再描画の回で、子を再描画させない手として children を使いました。 実は同じ手が、バケツリレーそのものにも効きます。
考え方はこうです。
NameTagを「Profileの中で作る」のをやめて、「Appの中で作って、できあがったものを下に流し込む」。
そうすれば、途中の4つは user を知る必要が一切なくなります。 中身が何なのかを知らないまま、children として置くだけになるからです。
途中の4つを、全部このかたちに書き換えます。 (Page / Sidebar / Menu / Profile の4ファイル。名前の部分だけ違います)
export default function Page({ children }) {
return (
<div style={{ border: '1px solid #ccc', padding: 12, marginTop: 12 }}>
<p>Page(名前を知らない)</p>
{children}
</div>
)
}
import はもう要りません(下の階層を自分で呼ばないため)。4つとも同じように書き換えてください。
そして src/App.jsx を、こうします。
import { useState } from 'react'
import Page from './Page'
import Sidebar from './Sidebar'
import Menu from './Menu'
import Profile from './Profile'
import NameTag from './NameTag'
export default function App() {
const [user, setUser] = useState({ name: 'koki' })
return (
<div style={{ padding: 16, fontFamily: 'sans-serif' }}>
<h1>reactlab</h1>
<button onClick={() => setUser({ name: user.name === 'koki' ? 'guest' : 'koki' })}>
名前を切り替える
</button>
<Page>
<Sidebar>
<Menu>
<Profile>
<NameTag user={user} />
</Profile>
</Menu>
</Sidebar>
</Page>
</div>
)
}
確認: 画面はさっきとまったく同じです。ボタンも同じように効きます。
user が出てくるのは App.jsx と NameTag.jsx の2つだけになりました。 途中の4つからは、user という単語が完全に消えています。
[スクリーンショット: 02_childrenで消える.png] grep -c user src/*.jsx の結果が、Page / Sidebar / Menu / Profile で 0 になっている画面を撮ってください。
道具を1つも足さずに、バケツリレーが消えました。
useStateのままで、importも増えていません。
なぜ効いたのかを一言で言うと、こうです。
バケツリレーは「値の問題」ではなく「組み立てる場所の問題」だった。 値を必要とする人(
NameTag)を、値を持っている人(App)の隣で組み立ててしまえば、渡す距離はゼロになる。
これは 合成(composition) と呼ばれる考え方で、React が一番最初に用意している手です。しかも、ついでに再描画も減ります(children は App が作ったものなので、途中の4つが再描画されても作り直されません。再描画の回の「手②」と同じ理屈です)。
それでも children で足りない場合
ここで正直に書きます。 上の書き換えには、はっきりした限界があります。
App.jsx を見てください。入れ子が5段になりました。 これが10段になったら読めません。 そして、この手が使えるのは「どこに何を置くかが、上から静的に決まっている」ときだけです。
次のどれかに当たったら、children では足りません。
| 状況 | なぜ足りないか |
|---|---|
| 深さが動的に決まる | 木構造のメニューや、再帰的に自分を呼ぶコンポーネント。上から組み立てられない |
| 読む場所が多すぎる | ユーザー名を画面の12箇所で使う。12個ぜんぶを App で組み立てるのは無理 |
| 横断的な関心事 | テーマ・言語・ログイン情報。「たまたま今そこにある部品」が突然必要になる |
| ルーターの下にいる | 画面ごとに中身が差し替わる。上から中身を渡す構造にできない |
判断はこうです。 ① まず
childrenを試す。② 入れ子が読めなくなるか、読む場所が3〜4箇所を超えたら Context を検討する。
この記事は、ここから ② に進みます。 ただし、①をやらずに②へ行ってはいけないというのが、この節の結論です。
③ Context を作って使う
ここからは、「ユーザー名」に加えて「テーマ(light / dark)」も配ります。 横断的な値が2つになった、という設定です。
作る・配る・受け取る
Context は3つの道具でできています。
| 道具 | 何をするか | 書く場所 |
|---|---|---|
createContext | 配送ルートを1本作る | コンポーネントの外(モジュールの一番上) |
<Ctx.Provider value={...}> | 「ここから下に、この値を配る」 | 値を持っている親 |
useContext(Ctx) | 一番近い上の Provider から受け取る | 値を使いたい子 |
src/AppContext.jsx を新しく作ります。
import { createContext, useContext, useState } from 'react'
const AppContext = createContext({ name: 'ゲスト', theme: 'light' })
export function AppProvider({ children }) {
const [name, setName] = useState('koki')
const [theme, setTheme] = useState('light')
return (
<AppContext.Provider value={{ name, theme, setName, setTheme }}>
{children}
</AppContext.Provider>
)
}
export function useApp() {
return useContext(AppContext)
}
3つのことをしています。
createContext(...)でルートを1本作った(AppContext)AppProviderが state を持ち、それをvalueに載せて配っているuseApp()はuseContext(AppContext)を呼ぶだけの、受け取り口
AppProviderがchildrenを受け取っていることに注目してください。 ②でやった手を、そのまま使っています。 Provider は、中身を知らないまま囲むだけの部品です。
src/NameTag.jsx を書き換えます。props をやめて、直接受け取ります。
import { useApp } from './AppContext'
export default function NameTag() {
const { name } = useApp()
return <strong>ようこそ {name} さん</strong>
}
テーマを表示する部品も作ります。src/ThemeBadge.jsx
import { useApp } from './AppContext'
export default function ThemeBadge() {
const { theme } = useApp()
return <span>テーマ: {theme}</span>
}
ボタンだけの部品も作ります。src/Controls.jsx
import { useApp } from './AppContext'
export default function Controls() {
const { setName, setTheme } = useApp()
return (
<div style={{ marginTop: 8 }}>
<button onClick={() => setName((n) => (n === 'koki' ? 'guest' : 'koki'))}>
名前を切り替える
</button>
<button onClick={() => setTheme((t) => (t === 'light' ? 'dark' : 'light'))}>
テーマを切り替える
</button>
</div>
)
}
そして src/App.jsx。入れ子はそのままにしますが、user を渡す線が消えます。
import { AppProvider } from './AppContext'
import Page from './Page'
import Sidebar from './Sidebar'
import Menu from './Menu'
import Profile from './Profile'
import NameTag from './NameTag'
import ThemeBadge from './ThemeBadge'
import Controls from './Controls'
export default function App() {
return (
<AppProvider>
<div style={{ padding: 16, fontFamily: 'sans-serif' }}>
<h1>reactlab</h1>
<Controls />
<ThemeBadge />
<Page>
<Sidebar>
<Menu>
<Profile>
<NameTag />
</Profile>
</Menu>
</Sidebar>
</Page>
</div>
</AppProvider>
)
}
確認: 2つのボタンが出て、押すと ようこそ guest さん と テーマ: dark がそれぞれ変わります。
NameTag は、5階層下にいるのに、誰からも props を受け取っていません。 これが Context です。
既定値が使われるのは、Provider の外にいるとき
ここが、この節で一番大事なところです。
createContext({ name: 'ゲスト', theme: 'light' }) の引数を覚えているでしょうか。あれは初期値ではありません。 Provider に囲まれていないときにだけ使われる、代わりの値です。
実験します。 App.jsx の中で、AppProvider の外に NameTag を1つ置いてみます。
export default function App() {
return (
<>
<NameTag />
<AppProvider>
...(さっきのまま)
</AppProvider>
</>
)
}
確認: 画面の一番上に、こう出ます。
ようこそ ゲスト さん
エラーは出ません。 赤い画面も出ません。コンソールにも何も出ません。ただ「ゲスト」と表示されるだけです。
[スクリーンショット: 03_Provider外の既定値.png] Provider の外に置いた NameTag が「ようこそ ゲスト さん」と出ていて、コンソールにエラーが1件も無い画面を撮ってください。
これが一番危ない挙動です。 実際の開発では、こう出ます。
- 本番だけログインユーザーが「ゲスト」になる。 開発では気付かない
- Provider を別のファイルに移した拍子に、一部のツリーが外に出る。 誰も気付かない
- テストで単体レンダリングしたら、テストは通るのに本番で壊れる
囲み忘れは、必ずやります。 問題は、やったことに気付けないことです。
気付けるようにする — カスタムフックで投げる
直し方は決まっています。 既定値を null にして、受け取り口で throw します。
src/AppContext.jsx の2箇所を書き換えます。
import { createContext, useContext, useState } from 'react'
const AppContext = createContext(null)
export function AppProvider({ children }) {
const [name, setName] = useState('koki')
const [theme, setTheme] = useState('light')
return (
<AppContext.Provider value={{ name, theme, setName, setTheme }}>
{children}
</AppContext.Provider>
)
}
export function useApp() {
const ctx = useContext(AppContext)
if (!ctx) {
throw new Error('useApp() は <AppProvider> の中でしか使えません')
}
return ctx
}
確認: さっきの「Provider の外の NameTag」を置いたまま保存すると、画面が赤くなり、書いたメッセージがそのまま出ます。
Uncaught Error: useApp() は <AppProvider> の中でしか使えません
「静かに間違う」が「うるさく止まる」に変わりました。 これは、本線のエラーの読み方で書いた「失敗は早く・大きく」と同じ話です。
AppContextをexportしないことも一緒に効いています。外に出さなければ、useContext(AppContext)を直接呼ぶ人が現れません。 入口がuseApp()1つに絞られるので、チェックを必ず通ります。
確認できたら、Provider の外に置いた NameTag は消してください。 App.jsx を、さっきの <AppProvider> で全体を囲んだ形に戻します。
既定値を書いていいのは、こういうときだけです。
| 既定値 | 使ってよい場面 |
|---|---|
null + throw | ほぼ全部。 ログイン情報・設定・API クライアントなど、無かったら困るもの |
| 意味のある値 | 無くても正しく動くとき。例:テーマの既定を light にして、Provider が無いページでも表示できるようにする |
迷ったら null + throw です。「無かったら困るのか」を自分に聞いて、困るなら投げます。
④ Context の代償を、再描画の回数で見る
ここからが本題です。 バケツリレーは消えました。では、何を失ったのか。
数える準備をする
3つの部品に、呼ばれた回数を出す行を足します。やり方は再描画の回と同じで、カウンターは関数の外に置きます(中に置くと毎回 0 に戻ります)。
src/NameTag.jsx
import { useApp } from './AppContext'
let renders = 0
export default function NameTag() {
const { name } = useApp()
renders += 1
console.log('NameTag:', renders)
return <strong>ようこそ {name} さん</strong>
}
src/ThemeBadge.jsx と src/Controls.jsx にも、同じ3行を足します(変数名 renders、ログの文字列だけ ThemeBadge: Controls: に変えます)。
そして、Context とまったく関係ない state を1つ足します。src/AppContext.jsx の AppProvider に、カウンターを1つ入れます。
export function AppProvider({ children }) {
const [name, setName] = useState('koki')
const [theme, setTheme] = useState('light')
const [count, setCount] = useState(0)
return (
<AppContext.Provider value={{ name, theme, setName, setTheme }}>
<button onClick={() => setCount(count + 1)}>関係ないカウンター: {count}</button>
{children}
</AppContext.Provider>
)
}
このボタンは、
nameにもthemeにも触りません。valueにcountは入っていません。だから、Context を読んでいる部品には何の関係もないはずです。
関係ないボタンで、全員が再描画される
ブラウザで F12 を開き、Console を表示します。 一度ページを再読み込みして、ログを流します。
「関係ないカウンター」を3回押してください。
NameTag: 2
ThemeBadge: 2
Controls: 2
NameTag: 3
ThemeBadge: 3
Controls: 3
NameTag: 4
ThemeBadge: 4
Controls: 4
3つとも、押した回数だけ増えています。
[スクリーンショット: 04_全部再描画.png] 「関係ないカウンター」を3回押したあとの Console に、3つの部品のログが3回ずつ出ている画面を撮ってください。
name も theme も、1文字も変わっていません。 それなのに全員が再描画されました。理由はここです。
value={{ name, theme, setName, setTheme }}
この { } は、AppProvider が呼ばれるたびに、その場で新しく作られています。
中身が同じでも、入れ物が別物なら、React は「変わった」と判断します。
Object.is({ name: 'koki' }, { name: 'koki' })はfalseです(再描画の回で確かめました)。
Console でその場で確認できます。
> Object.is({ a: 1 }, { a: 1 })
false
Context は「配った値が変わったか」しか見ません。 count が変わって AppProvider が再描画される → value の { } が新しく作られる → Context は「変わった」と判断する → useContext している全員に配り直す。
これが Context の代償です。 バケツリレーでは「渡した相手」だけが影響を受けました。Context では、useContext している人全員が、ツリーのどこにいても影響を受けます。
useMemo で value を安定させる
直し方は決まっています。 value を毎回作らないようにします。
src/AppContext.jsx の AppProvider を書き換えます。
import { createContext, useContext, useMemo, useState } from 'react'
export function AppProvider({ children }) {
const [name, setName] = useState('koki')
const [theme, setTheme] = useState('light')
const [count, setCount] = useState(0)
const value = useMemo(
() => ({ name, theme, setName, setTheme }),
[name, theme]
)
return (
<AppContext.Provider value={value}>
<button onClick={() => setCount(count + 1)}>関係ないカウンター: {count}</button>
{children}
</AppContext.Provider>
)
}
setName と setTheme を依存配列に入れていないのは、useState が返す set... は React が同じものを返し続けると保証しているからです(useMemo の回で扱いました)。
確認: ページを再読み込みして、「関係ないカウンター」を3回押します。
(何も出ない)
Console に1行も出ません。 name も theme も変わっていないので、useMemo が前回と同じオブジェクトを返し、Context は「変わっていない」と判断しました。
ProviderのvalueをuseMemoで包むのは、Context を書くときの定型です。 例外のほうが珍しいと思って構いません。
それでも「a を変えたのに、b の側も再描画される」
まだ終わりません。 今度は「テーマを切り替える」を1回押してください。
NameTag: 2
ThemeBadge: 2
Controls: 2
ThemeBadge が再描画されるのは当然です。 テーマを表示しているのだから、変わらなければ困ります。
問題は NameTag です。
NameTagはnameしか使っていません。themeが変わっても、画面に出る文字は1文字も変わりません。 それなのに再描画されました。
理由は、value が1つの箱だからです。
const value = useMemo(() => ({ name, theme, ... }), [name, theme])
theme が変われば、この箱は作り直されます。 そして React は、「箱が変わったか」しか見ません。 「箱の中の、その人が使っているプロパティが変わったか」は見ていません。
ここが、Context を「なんでも入れる大きな箱」にしてはいけない理由です。 入れれば入れるほど、関係ない人が巻き込まれます。
解法 — Context を分ける
React が用意している解決策は、1つだけです。
変わるタイミングが違う値は、別の Context にする。
src/AppContext.jsx を書き換えます。Context を2本にします。
import { createContext, useContext, useState } from 'react'
const NameContext = createContext(null)
const ThemeContext = createContext(null)
export function AppProvider({ children }) {
const [name, setName] = useState('koki')
const [theme, setTheme] = useState('light')
const [count, setCount] = useState(0)
return (
<NameContext.Provider value={name}>
<ThemeContext.Provider value={theme}>
<button onClick={() => setCount(count + 1)}>関係ないカウンター: {count}</button>
<button onClick={() => setName(name === 'koki' ? 'guest' : 'koki')}>
名前を切り替える
</button>
<button onClick={() => setTheme(theme === 'light' ? 'dark' : 'light')}>
テーマを切り替える
</button>
{children}
</ThemeContext.Provider>
</NameContext.Provider>
)
}
export function useName() {
const ctx = useContext(NameContext)
if (ctx === null) throw new Error('useName() は <AppProvider> の中でしか使えません')
return ctx
}
export function useTheme() {
const ctx = useContext(ThemeContext)
if (ctx === null) throw new Error('useTheme() は <AppProvider> の中でしか使えません')
return ctx
}
value に文字列をそのまま入れているので、useMemo はもう要りません。 'koki' と 'koki' は、Object.is で同じだからです。箱をやめれば、包む必要も消えます。
if (!ctx)ではなくif (ctx === null)にしました。 配る値が文字列や数値のとき、''や0は!ctxがtrueになってしまい、正常な値なのに例外を投げます。 実際にこれで30分溶かしました。
NameTag と ThemeBadge の import を直します。
import { useName } from './AppContext'
let renders = 0
export default function NameTag() {
const name = useName()
renders += 1
console.log('NameTag:', renders)
return <strong>ようこそ {name} さん</strong>
}
ThemeBadge は useTheme() を使う形に、同じように直します。ボタンは Provider の中に移したので、Controls.jsx は App.jsx から外して構いません(import と <Controls /> の行を消します)。
確認: ページを再読み込みして、「テーマを切り替える」を3回押します。
ThemeBadge: 2
ThemeBadge: 3
ThemeBadge: 4
NameTag のログが、1行も出なくなりました。
[スクリーンショット: 05_Context分割後.png] テーマを3回切り替えても ThemeBadge のログだけが増え、NameTag が増えていない Console を撮ってください。
| 状態 | 「テーマ切替」1回で再描画される部品 |
|---|---|
1本の Context(useMemo 無し) | NameTag / ThemeBadge / Controls の3つ |
1本の Context(useMemo 有り) | NameTag / ThemeBadge / Controls の3つ(useMemo で減るのは、関係ないカウンターを押したとき) |
| 2本に分割 | ThemeBadge だけ |
⑤ 状態と更新関数を、別の Context に分ける
まだ、もう1段あります。
さっき Controls を外しましたが、現実のアプリには「値を書き換えるだけで、値を読まない部品」が必ずいます。 ログアウトボタン、テーマ切替スイッチ、リセットボタン。これらは setXxx しか使いません。
そういう部品を、name が変わるたびに再描画するのは、完全な無駄です。
やることは1つです。
「読むための Context」と「書くための Context」を分ける。
src/AppContext.jsx に、3本目を足します。
import { createContext, useContext, useMemo, useState } from 'react'
const NameContext = createContext(null)
const ThemeContext = createContext(null)
const ActionsContext = createContext(null)
export function AppProvider({ children }) {
const [name, setName] = useState('koki')
const [theme, setTheme] = useState('light')
const actions = useMemo(
() => ({
toggleName: () => setName((n) => (n === 'koki' ? 'guest' : 'koki')),
toggleTheme: () => setTheme((t) => (t === 'light' ? 'dark' : 'light')),
}),
[]
)
return (
<ActionsContext.Provider value={actions}>
<NameContext.Provider value={name}>
<ThemeContext.Provider value={theme}>{children}</ThemeContext.Provider>
</NameContext.Provider>
</ActionsContext.Provider>
)
}
export function useName() {
const ctx = useContext(NameContext)
if (ctx === null) throw new Error('useName() は <AppProvider> の中でしか使えません')
return ctx
}
export function useTheme() {
const ctx = useContext(ThemeContext)
if (ctx === null) throw new Error('useTheme() は <AppProvider> の中でしか使えません')
return ctx
}
export function useAppActions() {
const ctx = useContext(ActionsContext)
if (ctx === null) throw new Error('useAppActions() は <AppProvider> の中でしか使えません')
return ctx
}
useMemo の依存配列が [](空)であることが、この節の要点です。
- 中で
nameを読んでいない(setName((n) => ...)の関数型更新を使っているため、今の値を知らなくていい。props と state の回で扱いました) setName/setThemeは React が安定させている
だから actions は、アプリが動いている間ずっと同じオブジェクトです。 何が変わっても、この Context は一度も「変わった」と言いません。
src/Controls.jsx を書き換えて、App.jsx に戻します。
import { useAppActions } from './AppContext'
let renders = 0
export default function Controls() {
const { toggleName, toggleTheme } = useAppActions()
renders += 1
console.log('Controls:', renders)
return (
<div style={{ marginTop: 8 }}>
<button onClick={toggleName}>名前を切り替える</button>
<button onClick={toggleTheme}>テーマを切り替える</button>
</div>
)
}
src/App.jsx は、Controls を AppProvider の中に置くだけです。
import { AppProvider } from './AppContext'
import Page from './Page'
import Sidebar from './Sidebar'
import Menu from './Menu'
import Profile from './Profile'
import NameTag from './NameTag'
import ThemeBadge from './ThemeBadge'
import Controls from './Controls'
export default function App() {
return (
<AppProvider>
<div style={{ padding: 16, fontFamily: 'sans-serif' }}>
<h1>reactlab</h1>
<Controls />
<ThemeBadge />
<Page>
<Sidebar>
<Menu>
<Profile>
<NameTag />
</Profile>
</Menu>
</Sidebar>
</Page>
</div>
</AppProvider>
)
}
確認: ページを再読み込みして、2つのボタンを交互に、合計6回押します。
Controls: 1
NameTag: 1
ThemeBadge: 1
NameTag: 2
ThemeBadge: 2
NameTag: 3
ThemeBadge: 3
NameTag: 4
ThemeBadge: 4
Controls は 1 のまま、二度と出てきません。
ここで、もう1つ大事なことが確認できます。 App の中身(Page 以下の5階層)も、一度も再描画されていません。
state を
AppではなくAppProviderの中に持たせ、AppProviderはchildrenを返すだけにしたからです。childrenの中身を作っているのはAppで、Appは state を持っていないので再描画されません。(②で使った手が、ここで効いています)
もし state を App に置いていたら、App が再描画され、Page 以下の5階層が毎回全部呼ばれます。 Context の設計で一番効くのは、実は「state を Provider の中に閉じ込めること」です。
| 押したボタン | 再描画される部品 |
|---|---|
| 名前を切り替える | NameTag だけ |
| テーマを切り替える | ThemeBadge だけ |
| (Controls は) | 初回の1回だけ。以後ゼロ |
バケツリレーは消え、無駄な再描画もゼロになりました。 ここが、Context を素の React だけで書いたときの到達点です。
⑥ どこまで Context を使うか
判断の基準は、たった2つの掛け算です。
① どれくらいの頻度で変わるか × ② どれくらい多くの場所から読まれるか
「めったに変わらない × たくさんの場所から読まれる」が、Context の得意分野です。 逆は、全部苦手です。
| 値 | 向くか | 理由 |
|---|---|---|
| テーマ(light / dark) | ⭕ 向く | 切り替えるのは1日に数回。 読む場所は画面のほぼ全部 |
| 表示言語(ja / en) | ⭕ 向く | 同上。変わったら全部が変わるべきなので、全員の再描画が正しい |
| ログイン中のユーザー情報 | ⭕ 向く | ログインとログアウトのときしか変わらない。 読む場所は多い |
| API のクライアント・設定値 | ⭕ 向く | 一度作ったら変わらない。 そもそも再描画が起きない |
| モーダルの開閉 | 🔺 場合による | 開閉のたびに全員が再描画される。 読む場所が少ないなら children で足りる |
| フォームの入力値 | ❌ 向かない | 1文字打つたびに、読んでいる全員が再描画される。 入力が重くなる典型 |
| マウス座標・スクロール位置 | ❌ 向かない | 秒間何十回も変わる。 Context に載せた瞬間、画面全体が固まる |
| 1秒ごとのタイマー | ❌ 向かない | 時計を出したいだけで、アプリ全体が毎秒再描画される |
一番よくある事故は、フォームです。 「入力値をどこからでも読めると便利だから」と Context に載せると、1文字打つたびに useContext している全員が再描画されます。 入力欄の反応が目に見えて遅くなり、原因が入力欄そのものには無いので、探すのに時間がかかります。
フォームの入力値は、その入力欄の近くに置きます。 遠くから読みたくなったら、それは「その値を、本当に遠くで読む必要があるのか」を疑う合図です。
迷ったときの一言。 「これが変わったとき、画面のほとんどが変わるべきか?」 YES なら Context。NO なら、Context に載せると無駄が出ます。
⑦ Context は「状態管理ライブラリ」ではない
ここが、この記事で一番言いたいことです。
Context を覚えると、「これで状態管理ライブラリは要らない」と言いたくなります。私も一度そう思いました。 半分だけ正しくて、半分は間違いです。
役割が違います。
| 仕事 | Context | 状態管理ライブラリ |
|---|---|---|
| 値を、離れた場所へ届ける | ⭕ これが仕事 | ⭕ できる |
| 値を保持する | ❌ していない(useState がやっている) | ⭕ 自分で持つ |
「この人は theme しか使っていないから起こさない」 | ❌ できない | ⭕ これが本業(セレクタ) |
| 更新の履歴を追う | ❌ | ⭕ 専用の DevTools がある |
| React の外から更新する | ❌ | ⭕ できるものが多い |
Context は「配送業者」です。 荷物を預かって、購読している全員に同じものを配ります。 「この人には要らないから配らない」という判断はしません。 それをやるのが、状態管理ライブラリです。
④でやったことを思い出してください。 「theme を使っていない NameTag を再描画させない」ために、私たちがやったのはContext を物理的に2本に分けることでした。Context 側に「必要な人だけ起こす」機能が無いから、構造で解決するしかなかったわけです。
値が3つなら Context を3本で済みます。20個になったら、Provider が20段になります。 そこが、素の Context の限界です。
ライブラリを検討していい条件は、はっきりしています。
- Context を分けた本数が、5〜6本を超えて管理できなくなった
- 「値の一部分だけを購読したい」(セレクタが欲しい)と、実測の結果から言えるようになった
- 更新のロジックが複雑で、どこで何が変わったのか追えなくなった
- サーバーから取ったデータのキャッシュ・再取得・古さの管理まで必要になった(これは Context の話ですらなく、別の種類の道具の仕事です)
どれにも当たらないなら、useState + children + Context 数本で足ります。 そして個人開発の大半は、ここに収まります。
逆の順番でやってはいけません。
❌ 「規模が大きくなりそうだから、最初からライブラリを入れる」 ⭕ 「
childrenで足りない → Context を入れた → 分割しても管理できなくなった → ライブラリを検討する」
この記事でやったこと全部が、ライブラリを入れたあとも無駄になりません。 「何が再描画を起こすのか」「なぜ分けるのか」は、どのライブラリでも同じ理屈で動いているからです。
つまずいたところ
最初、useMemo を付ければ全部解決すると思っていました。 ④で useMemo を入れて、関係ないカウンターでログが止まったのを見て、「終わった」と思って記事を閉じかけました。 そのあと何気なくテーマ切替を押したら、NameTag のログが増えていて、そこから半日かかりました。 useMemo が解決したのは「値が変わっていないのに変わったことになる」問題だけで、「値が本当に変わったときに、関係ない人まで起こされる」問題には、最初から何の効果もありません。 別の問題を、同じ道具で殴ろうとしていました。
if (!ctx) throw で30分溶かしました。 分割して value に文字列を直接入れたところ、テーマ名を空文字にした瞬間に例外が飛びました。 「Provider は確かに囲んでいるのに」と、App.jsx の構造を何度も見直しました。!'' が true だという、React とまったく関係ない JavaScript の話でした(JavaScript の基本でやった、あの落とし穴です)。配る値がオブジェクトなら !ctx で構いませんが、プリミティブなら === null で比べます。
children の手を、この記事を書くまで「再描画対策の小技」だと思っていました。 再描画の回で使ったときは、速さの話として理解していました。バケツリレーそのものが消えることに気付いていませんでした。 ②を書きながら grep -c user src/*.jsx の結果が 0 になったのを見て、Context を入れる前にやることが1つあったと分かりました。入れなくて済むなら、それが一番速いです。
カウンターを関数の中に書いて、ずっと 1 しか出ませんでした。 再描画の回でまったく同じことをやったのに、別のプロジェクトで最初から書いたら、また同じ間違いをしました。 一度やった失敗は、環境が変わると戻ってきます。
AppContext を export していた時期があり、useApp() を通さずに useContext(AppContext) を直接呼んでいる箇所が残っていました。 当然そこだけ throw を通らないので、囲み忘れが1箇所だけ静かに生き残っていました。 チェックを書いても、迂回路があれば意味がありません。 Context 本体は export しない、と決めてから起きなくなりました。
後片づけ
~/reactlab は練習用に作ったものなので、丸ごと消して構いません。 本線で使った ~/react-demo/ とは別物です。消す前に、何を消すのかを目で見ます。
開発サーバーを止めます。 動かしている端末で Ctrl + C を押します。止まったことを確認します。
確認: 何も返らなければ、止まっています。
ポートを閉じます。
確認: 一覧に 5179/tcp が残っていなければ成功です。
プロジェクトを消します。
確認: reactlab が消えていれば片づけ完了です。
消さずに残す場合は、
src/main.jsxのStrictModeを必ず戻してください。 ①で数を数えるために外しました。外したまま開発を続けると、StrictModeが見つけてくれるはずのバグを見逃します。
import { StrictMode } from 'react'
import { createRoot } from 'react-dom/client'
import './index.css'
import App from './App.jsx'
createRoot(document.getElementById('root')).render(
<StrictMode>
<App />
</StrictMode>
)
戻し方: もう一度やりたくなったら、①の
npm create vite@latest reactlab -- --template reactからやるだけです。数分で戻せます(node_modulesは消してよい)。
まとめ
- バケツリレーは「値の問題」ではなく「組み立てる場所の問題」。 まず
childrenを試す。道具は要らない childrenで足りないのは4つの場合だけ。 深さが動的 / 読む場所が多すぎる / 横断的な値 / ルーターの下- Context は3つの道具でできている。
createContextで作り、Providerで配り、useContextで受け取る - 既定値が使われるのは、Provider の外にいるとき。 囲み忘れてもエラーは出ず、静かに既定値が表示される
- だから既定値は
nullにして、受け取り口のフックでthrowする。 Context 本体はexportしない(迂回路を作らない) - 配る値がプリミティブなら
if (!ctx)ではなくif (ctx === null)。''と0で誤爆する value={{ a, b }}は毎回別物。 関係ないボタン1つで、useContextしている全員が再描画されるuseMemoでvalueを包むのは定型。 ただし直るのは「変わっていないのに変わったことになる」問題だけaを変えると、bしか使っていない人も再描画される。useMemoでは直らない。Context を分けるしかない- 状態と更新関数を別の Context に分けると、「書くだけの部品」は二度と再描画されない。
actionsの依存配列は[]にできる - state は
Appではなく Provider の中に閉じ込め、Provider はchildrenを返すだけにする。 これが一番効く - 向くのは「めったに変わらない × 読む場所が多い」値。 テーマ・言語・ログイン情報
- フォームの入力値は載せない。 1文字打つたびに全員が再描画される
- Context は配送業者であって、状態管理ライブラリではない。 「この人には要らない」という判断をしない
- ライブラリは、Context を分けても管理できなくなってから検討する。 最初から入れない
参考リンク
- roadmap.sh — React
- React 公式 — useContext
- React 公式 — createContext
- React 公式 — Context でデータを深く受け渡す
- React 公式 — Context を使う前に
- React 公式 — Reducer と Context を組み合わせる
- React 公式 — state のリフトアップ
- React 公式 — useMemo
- React 公式 — memo
- MDN — Object.is
- Vite 公式ガイド
次に読む
この記事は 【深掘り】React の 8 / 24 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | useRefの2つの用途 — 中身がnullで落ちる |
| → 次の記事 | カスタムフック — 似ているだけでは共通化しない |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- Context の代償を再描画の回数で見る
- 状態と更新関数を分ける
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント