Context — 入れたら全部再描画される

Contextと再描画。Contextの共有カードとコンポーネント、更新マーク。

Contextは便利ですが、入れると全部が再描画されます。なぜそうなるのかを確かめ、分割して影響範囲を狭めます。

前回: useRefの2つの用途 — 中身がnullで落ちる

これは深掘りです。本線の順路ではありません。 本線のコンポーネントと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 は状態管理ライブラリではないこと。配達はするが、誰に配らないかは判断しない

この記事でやること

  1. ~/reactlab/ を新しく作り、ポート 5179 で起動する
  2. 5階層のバケツリレーを実際に書き、それを children で消す
  3. createContext / Provider / useContext で Context を入れ、囲み忘れをカスタムフックの throw で潰す
  4. 関係ないボタンで全員が再描画されるのを数え、useMemo と Context の分割で減らす
  5. 状態と更新関数を別の Context に分け、「書くだけの部品」の再描画が止まることを実測する

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
バケツリレー(prop drilling)途中のコンポーネントが、使いもしない値を受け取って下に渡し続けること
Contextツリーの途中を飛ばして、下にいる誰にでも値を届けるReact の仕組み
createContextContext を1つ作る関数。返ってくるのは「箱」ではなく、Provider を持ったオブジェクト
Provider「ここから下の全員に、この値を配る」と宣言するコンポーネント。 <Ctx.Provider value={...}>
useContext一番近い上の Provider から、値を受け取るフック。受け取る=購読するという意味になる
既定値(default value)createContext(既定値) に書いた値。Provider に囲まれていないときにだけ使われる
購読(subscribe)値が変わったら教えてもらう約束をすること。 useContext した時点で、自動的にこの約束が結ばれる
横断的な関心事テーマ・言語・ログイン情報のように、画面のどこからでも参照される種類の値

再描画(re-render)と参照の比較(Object.is)は、再描画の回を数える記事で扱っています。 この記事では、そこで作った数え方をそのまま使います。


① 練習場を作る

本線で作った ~/react-demo/ は触りません。 壊しながら試すので、別のプロジェクトを1つ作ります。

VMの中で実行します。

bash
$ cd ~
$ npm create vite@latest reactlab -- --template react
$ cd reactlab
$ npm install

確認: ls src で App.jsx と main.jsx が出れば成功です。

bash
$ ls src
App.css  App.jsx  assets  index.css  main.jsx

ポートを開けます。この記事では 5179 を使います。(他の深掘り記事の練習場と同時に動かしても、ぶつからないようにするためです)

bash
$ sudo ufw allow 5179/tcp
$ sudo ufw status

確認: 一覧に 5179/tcp ALLOW が出ていれば成功です。

起動します。

bash
$ npm run dev -- --host 0.0.0.0 --port 5179

--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ファイルに出てきます。

bash
$ grep -c user src/*.jsx

この「使っていないのに書かなければならない」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>
  )
}

確認: 画面はさっきとまったく同じです。ボタンも同じように効きます。

bash
$ grep -c user src/*.jsx

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つのことをしています。

  1. createContext(...) でルートを1本作った(AppContext)
  2. AppProvider が state を持ち、それを value に載せて配っている
  3. 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 の限界です。

ライブラリを検討していい条件は、はっきりしています。

  1. Context を分けた本数が、5〜6本を超えて管理できなくなった
  2. 「値の一部分だけを購読したい」(セレクタが欲しい)と、実測の結果から言えるようになった
  3. 更新のロジックが複雑で、どこで何が変わったのか追えなくなった
  4. サーバーから取ったデータのキャッシュ・再取得・古さの管理まで必要になった(これは 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/ とは別物です。消す前に、何を消すのかを目で見ます。

bash
$ ls ~/reactlab
$ du -sh ~/reactlab

開発サーバーを止めます。 動かしている端末で Ctrl + C を押します。止まったことを確認します。

bash
$ ss -tlnp | grep 5179

確認: 何も返らなければ、止まっています。

ポートを閉じます。

bash
$ sudo ufw delete allow 5179/tcp
$ sudo ufw status

確認: 一覧に 5179/tcp が残っていなければ成功です。

プロジェクトを消します。

bash
$ rm -rf ~/reactlab
$ ls ~

確認: 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 を分けても管理できなくなってから検討する。 最初から入れない

参考リンク


次に読む

この記事は 【深掘り】React の 8 / 24 本目です。

記事
← 前の記事useRefの2つの用途 — 中身がnullで落ちる
→ 次の記事カスタムフック — 似ているだけでは共通化しない

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend›React — Context
  • Context の代償を再描画の回数で見る
  • 状態と更新関数を分ける

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次