Reactで都道府県と市区町村の連動プルダウンを作る方法

​​React​TypeScript,useEffect,useState,フォーム

React で都道府県と市区町村の連動プルダウンを作るときは、市区町村の選択肢を state に持たず、選ばれている都道府県から描画のたびに計算します。そのうえで、都道府県を変えたときに市区町村の選択を空に戻せば、画面と state が食い違いません。会員登録や配送先の住所入力フォームのように、1つ目のプルダウンで2つ目の選択肢を絞り込む場面で使える書き方です。

私は検証環境で、市区町村の選択を空に戻さない書き方、イベントハンドラで戻す書き方、useEffect で戻す書き方を作り、画面の表示・state・フォームで送られる値を記録しました。市区町村の一覧をサーバーから取る書き方も試しています。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4 です。使ったのは react / react-dom 19.3.1、@types/react / @types/react-dom 19.3.0、typescript 7.0.2、esbuild 0.28.2、jsdom 31.0.0 です。.tsx を tsc で型チェックしてから esbuild で変換し、jsdom の上で動かしました。GIF は、同じコンポーネントを Playwright 1.63.0 と、それに付属の Chromium 153 で動かして撮ったものです。コンポーネントは <StrictMode> で包まずに描画し、画面への反映(コミット)の回数は <Profiler> で数えました。データは都道府県3つと、それぞれの市区町村3つだけです。サーバーは検証用に作った偽物で、こちらが合図するまで返事をしません。全国のデータや、住所の検索 API、フォームのライブラリと組み合わせる書き方は試していません。

市区町村の選択肢は、都道府県から描画のたびに計算する

データは、都道府県をキーにして市区町村の配列を持つオブジェクトにしました。TypeScript 4.9 のリリースノートにある satisfies の説明のとおり、satisfies は式の型を変えずに、その型が指定した型に合うかを確かめます。そのため Prefecture は、キーを並べた '東京都' | '大阪府' | '福岡県' になります。

ts
// 検証用の小さなデータ。都道府県ごとに、市区町村の一部だけを入れている。
export const CITIES = {
  東京都: ['千代田区', '新宿区', '八王子市'],
  大阪府: ['大阪市', '堺市', '豊中市'],
  福岡県: ['福岡市', '北九州市', '久留米市'],
} satisfies Record<string, string[]>;

export type Prefecture = keyof typeof CITIES;
export const PREFECTURES = Object.keys(CITIES) as Prefecture[];

export function isPrefecture(value: string): value is Prefecture {
  return value in CITIES;
}

コンポーネントでは、選ばれている都道府県と市区町村だけを state にします。市区町村の選択肢 cities は、都道府県から計算できるので state にしません。公式ドキュメントの、props や state から求められる値についての説明でも、今ある props や state から計算できるものは state に入れず、描画の中で計算するよう勧めています。

tsx
import { useState, type ChangeEvent } from 'react';
import { CITIES, PREFECTURES, isPrefecture, type Prefecture } from './data';

export function DependentSelect() {
  const [prefecture, setPrefecture] = useState<Prefecture | ''>('');
  const [city, setCity] = useState('');
  // 市区町村の選択肢は state にせず、描画のたびに都道府県から求める
  const cities = prefecture ? CITIES[prefecture] : [];

  function handlePrefectureChange(e: ChangeEvent<HTMLSelectElement>) {
    const value = e.target.value;
    setPrefecture(isPrefecture(value) ? value : '');
    setCity(''); // 都道府県を変えたら、市区町村の選択を空に戻す
  }

  return (
    <form>
      <select name="prefecture" value={prefecture} onChange={handlePrefectureChange}>
        <option value="">都道府県を選択</option>
        {PREFECTURES.map((p) => <option key={p} value={p}>{p}</option>)}
      </select>
      <select name="city" value={city} onChange={(e) => setCity(e.target.value)}
        disabled={!prefecture}>
        <option value="">市区町村を選択</option>
        {cities.map((c) => <option key={c} value={c}>{c}</option>)}
      </select>
      <output>state: {prefecture || '(なし)'} / {city || '(なし)'}</output>
    </form>
  );
}

都道府県が決まるまでは、市区町村のプルダウンを disabled にして選べないようにしています。検証用に、state の中身を <output> に出しました。

東京都を選び、新宿区を選び、都道府県を大阪府に変えたときの記録です。「画面」はプルダウンに見えている項目、「送信される値」は <form> から作った FormData の中身、「コミット」はその操作で画面に反映された回数です。

text
$ node run.mjs DependentSelect
  最初:
    画面: 都道府県=都道府県を選択 市区町村=市区町村を選択(選べない) 選択肢=[市区町村を選択]
    state: (なし) / (なし)  送信される値: prefecture=
    コミット: 1回
  東京都を選んだあと:
    画面: 都道府県=東京都 市区町村=市区町村を選択 選択肢=[市区町村を選択,千代田区,新宿区,八王子市]
    state: 東京都 / (なし)  送信される値: prefecture=東京都&city=
    コミット: 1回
  新宿区を選んだあと:
    画面: 都道府県=東京都 市区町村=新宿区 選択肢=[市区町村を選択,千代田区,新宿区,八王子市]
    state: 東京都 / 新宿区  送信される値: prefecture=東京都&city=新宿区
    コミット: 1回
  都道府県を大阪府に変えたあと:
    画面: 都道府県=大阪府 市区町村=市区町村を選択 選択肢=[市区町村を選択,大阪市,堺市,豊中市]
    state: 大阪府 / (なし)  送信される値: prefecture=大阪府&city=
    コミット: 1回

大阪府に変えると、選択肢が大阪府の市に入れ替わり、市区町村は「市区町村を選択」に戻りました。最初の状態では、disabled にした市区町村のプルダウンは FormData に入っていません(prefecture= だけです)。

市区町村を空に戻さないと、画面と state が食い違う

上のコードから setCity('') だけを外した StaleCity を作り、同じ操作をしました。都道府県の onChange では setPrefecture だけを呼びます。

text
$ node run.mjs StaleCity
  (東京都と新宿区を選ぶところまでは DependentSelect と同じなので省略)
  都道府県を大阪府に変えたあと:
    画面: 都道府県=大阪府 市区町村=市区町村を選択 選択肢=[市区町村を選択,大阪市,堺市,豊中市]
    state: 大阪府 / 新宿区  送信される値: prefecture=大阪府&city=
    コミット: 1回

画面の市区町村は「市区町村を選択」に戻って見えますが、state には「新宿区」が残りました。state は、大阪府の選択肢にない新宿区を持ったままの「大阪府 / 新宿区」です。<form> から送られる値は city=(空)で、画面と同じです。FormData ではなく state の値を送る書き方では、この「大阪府 / 新宿区」が使われます。

<select> のリファレンスには、value に渡す文字列は、中にあるどれかの <option> の value と一致しなければならない、とあります。StaleCity は、都道府県を変えた時点でこの条件を満たさなくなっています。

次の GIF は、StaleCity(①)と DependentSelect(②)をブラウザの画面に縦に並べ、同じ順で選んだ様子です。画面の上部に「操作 1回目/3回」のように何回目かが出て、その下に何を選ぶかが出ます。プルダウンをクリックした瞬間に、カーソルのまわりにピンクの円が出ます。選んだ直後は、値が変わった欄がピンクになります。3回目に大阪府へ変えたとき、①は state に「新宿区」が残り、②は「(なし)」に戻ります。最後に、結果の文と両方の state をピンクにして見せています。

StaleCityとDependentSelectを縦に並べ、東京都、新宿区、大阪府の順に選んだときの、プルダウンとstateと送られる値の変化
GIFアニメーション:2つのフォームで、東京都、新宿区の順に選んでから、都道府県を大阪府に変える。①は市区町村のstateに新宿区が残り、②は空に戻る

useEffect で空に戻すと、古い組み合わせのまま一度描画される

都道府県が変わったら市区町村を空に戻す処理は、useEffect でも書けます。

tsx
useEffect(() => {
  setCity('');
}, [prefecture]);

StaleCity にこの useEffect を足した EffectReset を作り、描画のたびに state を記録しました。

text
$ node run.mjs EffectReset
  (東京都と新宿区を選ぶところまでは省略)
  都道府県を大阪府に変えたあと:
    画面: 都道府県=大阪府 市区町村=市区町村を選択 選択肢=[市区町村を選択,大阪市,堺市,豊中市]
    state: 大阪府 / (なし)  送信される値: prefecture=大阪府&city=
    描画: 大阪府 / 新宿区 → 描画: 大阪府 / (なし)
    コミット: 2回

最後の state は「大阪府 / (なし)」で、DependentSelect と同じになりました。ただ、その前に「大阪府 / 新宿区」の組み合わせで1回描画され、useEffect の中の setCity('') でもう1回描画されています。画面への反映も2回です。公式ドキュメントの、props が変わったときに state の一部を調整する例でも、Effect で state を戻すと、まず古い値のまま描画され、そのあと再描画が起きると説明しています。

都道府県を変えるのは、利用者がプルダウンを操作したときだけです。その操作に合わせて市区町村も戻すなら、DependentSelect のように onChange のイベントハンドラの中で setCity('') を呼びます。上の DependentSelect の記録では、大阪府に変えたときのコミットは1回で、state はその時点で「大阪府 / (なし)」でした。

市区町村の一覧をサーバーから取るときは、古い返事を捨てる

全国の市区町村を最初から全部持たず、都道府県を選ぶたびにサーバーから取る書き方もあります。公式ドキュメントのデータ取得の例では、表示している間は条件に合わせてサーバーのデータと同期し続ける処理なので、データの取得は Effect に置く、と説明しています。ここでも、選ばれている都道府県に合わせて一覧を取る処理を useEffect に書きます。

試したのは、東京都を選び、その返事が届く前に大阪府へ変え、サーバーが大阪府、東京都の順に返事をする場面です。偽のサーバーの fetchCities は、こちらが合図するまで返事をしないので、返事の順番を入れ替えられます。

まず、useEffect の中で取った一覧をそのまま setCities に入れる AsyncNoIgnore です。

tsx
useEffect(() => {
  if (!prefecture) return;
  fetchCities(prefecture).then((list) => {
    setCities(list);
  });
}, [prefecture]);
text
$ node run.mjs AsyncNoIgnore
  (最初から、大阪府を選んだ直後までは省略)
  大阪府の返事が先に届いたあと:
    画面: 都道府県=大阪府 市区町村=市区町村を選択 選択肢=[市区町村を選択,大阪市,堺市,豊中市]
    state: 大阪府 / (なし)  送信される値: prefecture=大阪府&city=
    サーバー: 要求:東京都 → 要求:大阪府 → 返事:大阪府
    コミット: 1回
  東京都の返事が遅れて届いたあと:
    画面: 都道府県=大阪府 市区町村=市区町村を選択 選択肢=[市区町村を選択,千代田区,新宿区,八王子市]
    state: 大阪府 / (なし)  送信される値: prefecture=大阪府&city=
    サーバー: 要求:東京都 → 要求:大阪府 → 返事:大阪府 → 返事:東京都
    コミット: 1回

遅れて届いた東京都の返事で一覧が上書きされ、都道府県は大阪府なのに、市区町村の選択肢が東京都の区と市になりました。

同じデータ取得の例では、これを競合状態(race condition)と呼び、Effect のクリーンアップ関数で古い返事を無視する書き方を示しています。それに合わせたのが次の AsyncCities です。

tsx
import { useEffect, useState, type ChangeEvent } from 'react';
import { PREFECTURES, isPrefecture, type Prefecture } from './data';
import { fetchCities } from './server';

export function AsyncCities() {
  const [prefecture, setPrefecture] = useState<Prefecture | ''>('');
  const [city, setCity] = useState('');
  const [cities, setCities] = useState<string[]>([]);

  useEffect(() => {
    if (!prefecture) return;
    let ignore = false;
    fetchCities(prefecture).then((list) => {
      if (!ignore) setCities(list); // 古い要求の返事は捨てる
    });
    return () => {
      ignore = true;
    };
  }, [prefecture]);

  function handlePrefectureChange(e: ChangeEvent<HTMLSelectElement>) {
    const value = e.target.value;
    setPrefecture(isPrefecture(value) ? value : '');
    setCity('');
    setCities([]);
  }

  const loading = prefecture !== '' && cities.length === 0;
  return (
    <form>
      <select name="prefecture" value={prefecture} onChange={handlePrefectureChange}>
        <option value="">都道府県を選択</option>
        {PREFECTURES.map((p) => <option key={p} value={p}>{p}</option>)}
      </select>
      <select name="city" value={city} onChange={(e) => setCity(e.target.value)}
        disabled={cities.length === 0}>
        <option value="">{loading ? '読み込み中…' : '市区町村を選択'}</option>
        {cities.map((c) => <option key={c} value={c}>{c}</option>)}
      </select>
      <output>state: {prefecture || '(なし)'} / {city || '(なし)'}</output>
    </form>
  );
}

useEffect のリファレンスにあるとおり、依存配列の値が変わると、React は前の値でクリーンアップ関数を呼んでから、新しい値で Effect を動かします。そのため、東京都の要求の ignore は、大阪府に変えたあとの描画が反映された時点で true になります。handlePrefectureChange では、市区町村の選択と一緒に一覧も空に戻し、届くまでは「読み込み中…」と出して選べないようにしました。

text
$ node run.mjs AsyncCities
  (最初の状態は省略)
  東京都を選んだ直後:
    画面: 都道府県=東京都 市区町村=読み込み中…(選べない) 選択肢=[読み込み中…]
    state: 東京都 / (なし)  送信される値: prefecture=東京都
    サーバー: 要求:東京都
    コミット: 1回
  東京都の返事を待たずに大阪府を選んだ直後:
    画面: 都道府県=大阪府 市区町村=読み込み中…(選べない) 選択肢=[読み込み中…]
    state: 大阪府 / (なし)  送信される値: prefecture=大阪府
    サーバー: 要求:東京都 → 要求:大阪府
    コミット: 1回
  大阪府の返事が先に届いたあと:
    画面: 都道府県=大阪府 市区町村=市区町村を選択 選択肢=[市区町村を選択,大阪市,堺市,豊中市]
    state: 大阪府 / (なし)  送信される値: prefecture=大阪府&city=
    サーバー: 要求:東京都 → 要求:大阪府 → 返事:大阪府
    コミット: 1回
  東京都の返事が遅れて届いたあと:
    画面: 都道府県=大阪府 市区町村=市区町村を選択 選択肢=[市区町村を選択,大阪市,堺市,豊中市]
    state: 大阪府 / (なし)  送信される値: prefecture=大阪府&city=
    サーバー: 要求:東京都 → 要求:大阪府 → 返事:大阪府 → 返事:東京都
    コミット: 0回

東京都の返事はサーバーから届きましたが、選択肢は大阪府の市のまま変わらず、画面への反映(コミット)も起きませんでした。

返事のキャッシュや、同じ要求をまとめる処理までは、この書き方には入っていません。useEffect のリファレンスにある、Effect でのデータ取得に代わる方法の説明では、フレームワークを使っているならその取得の仕組みを使うこと、そうでなければ TanStack Query や useSWR などのクライアント側のキャッシュを検討することが勧められています。

​Posted by 86