Reactで、複数選択できるselectの値をstateで扱う方法

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

React で <select multiple> の値を state で扱うときは、state を文字列の配列にして value に渡し、onChange では e.target.selectedOptions から配列を作り直します。1つだけ選ぶ select と同じように e.target.value を使うと、最初の1つしか取れず、2つ目を選んでもすぐに外れてしまいます。検索の絞り込みで複数のカテゴリーを選ぶフォームや、使っている言語をいくつでも選べるアンケートのように、一覧(リストボックス)から複数の項目を選ばせる場面で使える書き方です。

私は検証環境で、正しい書き方と、e.target.value を使う書き方、value に文字列を渡す書き方、state を持たずに送信時に読む書き方を作り、画面で選ばれている項目と 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 の上で動かしました。jsdom では、option の selected を書き換えてから change イベントを出して、利用者が選んだときの操作の代わりにしています。GIF は、同じコンポーネントを Playwright 1.63.0 と、それに付属の Chromium 153 で動かし、マウスで実際にクリックして撮ったものです。スマートフォンのブラウザでの表示や操作、フォームのライブラリと組み合わせる書き方は試していません。

stateは配列にして、selectedOptionsから作り直す

選択肢は、value と表示名の組にしました。

ts
export const LANGUAGES = [
  { value: 'ts', label: 'TypeScript' },
  { value: 'py', label: 'Python' },
  { value: 'go', label: 'Go' },
  { value: 'rs', label: 'Rust' },
];

コンポーネントでは、選ばれている値を string[] の state に持ちます。公式リファレンスの <select> の props の説明にあるとおり、multiple={true} のときは value に文字列の配列を渡します。

tsx
import { useState, type ChangeEvent } from 'react';
import { LANGUAGES } from './options';

export function MultiSelect() {
  const [langs, setLangs] = useState<string[]>([]);

  function handleChange(e: ChangeEvent<HTMLSelectElement>) {
    // 選ばれている option をすべて取り出し、value の配列にする
    const values = Array.from(e.target.selectedOptions, (option) => option.value);
    setLangs(values);
  }

  return (
    <form>
      <select name="langs" multiple value={langs} onChange={handleChange} size={4}>
        {LANGUAGES.map((l) => <option key={l.value} value={l.value}>{l.label}</option>)}
      </select>
      <button type="button" onClick={() => setLangs([])}>すべて解除</button>
      <button type="button" onClick={() => setLangs(LANGUAGES.map((l) => l.value))}>すべて選択</button>
      <output>state: {JSON.stringify(langs)}</output>
    </form>
  );
}

MDN の selectedOptions の説明のとおり、selectedOptions は、いま選ばれている <option> 要素の一覧(HTMLCollection)です。配列ではないので、Array.from の2つ目の引数で value を取り出しながら配列にしています。公式リファレンスの、state で select を制御する例では、スプレッド構文で配列にしてから map しています。どちらも、選ばれている option の value を配列にする書き方です。

onChange では、いま選ばれているものをすべて読み直して、state を丸ごと置き換えます。クリックされた1つを state に足したり外したりする必要はありません。size={4} は、一度に見える行の数です。

検証環境(Ubuntu 24.04、Node.js 22)で、TypeScript を選び、Go と Rust を足し、TypeScript を外したときの記録です。「画面で選ばれている項目」は、DOM の option のうち selected になっているものです。

text
$ node run.mjs MultiSelect
  最初:
    画面で選ばれている項目: []  select.value: ""
    state: []
  TypeScript を選んだあと:
    画面で選ばれている項目: [TypeScript]  select.value: "ts"
    state: ["ts"]
  Ctrl を押しながら Go も選んだあと:
    画面で選ばれている項目: [TypeScript, Go]  select.value: "ts"
    state: ["ts","go"]
  さらに Rust も選んだあと:
    画面で選ばれている項目: [TypeScript, Go, Rust]  select.value: "ts"
    state: ["ts","go","rs"]
  TypeScript の選択を外したあと:
    画面で選ばれている項目: [Go, Rust]  select.value: "go"
    state: ["go","rs"]

画面と state が、毎回同じ組み合わせになっています。一方で、select.value は最初に選ばれている1つ("ts" や "go")だけです。

パソコンのブラウザで複数を選ぶには、Ctrl キー(macOS では Command キー)や Shift キーを押しながらクリックします。キーの組み合わせは OS やブラウザによって違うことが、MDN の <select> の説明に書かれています。

e.target.valueでは、最初に選ばれた1つしか取れない

1つだけ選ぶ select と同じつもりで、onChange を次のように書いたとします。select の書き方は同じで、違うのは onChange の関数だけです(ボタンは付けていません)。

tsx
function handleChange(e: ChangeEvent<HTMLSelectElement>) {
  setLangs([e.target.value]);
}

MDN の value の説明のとおり、select の value は、選ばれている option のうち最初のものの値です。そのため state には、いつも1つしか入りません。

同じ順に操作した記録です。

text
$ node run.mjs FirstOnly
  最初:
    画面で選ばれている項目: []  select.value: ""
    state: []
  TypeScript を選んだあと:
    画面で選ばれている項目: [TypeScript]  select.value: "ts"
    state: ["ts"]
  Ctrl を押しながら Go も選んだあと:
    画面で選ばれている項目: [TypeScript]  select.value: "ts"
    state: ["ts"]
  さらに Rust も選んだあと:
    画面で選ばれている項目: [TypeScript]  select.value: "ts"
    state: ["ts"]

(このあとの、TypeScript の選択を外す操作の記録は省きました。)

Go や Rust を足しても、state は ["ts"] のままです。しかも、画面の選択まで TypeScript だけに戻っています。value を渡した select では、React が state の値に合わせて選択を戻すからです。公式リファレンスの注意書きにも、value を渡すと、渡した値に select が強制的にそろえられると書かれています。利用者から見ると、2つ目を選んだ瞬間に外れてしまい、複数を選べないリストボックスになります。

Chromium で、①e.target.value を使う書き方と、②selectedOptions を使う書き方を縦に並べ、同じ順にクリックした様子です。2回目と3回目は、Ctrl キーを押しながらクリックしています。

上下2つのリストボックスに、TypeScript、Go、Rust の順にクリックする。上の①は TypeScript だけが選ばれたままで state は ["ts"]、下の②は3つとも選ばれ state は ["ts","go","rs"] になる
①e.target.value と②selectedOptions で、TypeScript・Go・Rust を順に選んだときの違い(2回目からは Ctrl を押しながら)

①は、Ctrl を押しながら Go や Rust をクリックしても、TypeScript だけが選ばれたままです。②は、クリックするたびに選ばれている項目が増え、state も同じ配列になります。

「すべて選択」と「すべて解除」は、stateを書き換えるだけ

state で選択を持っていれば、ボタンから選択を変えるのは簡単です。上の MultiSelect の2つのボタンは、それぞれ state に全部の値の配列と、空の配列を入れているだけです。

node run.mjs MultiSelect の続きで、2つのボタンを押したときの記録です。

text
  「すべて選択」を押したあと:
    画面で選ばれている項目: [TypeScript, Python, Go, Rust]  select.value: "ts"
    state: ["ts","py","go","rs"]
  「すべて解除」を押したあと:
    画面で選ばれている項目: []  select.value: ""
    state: []

state を変えると、画面の選択もそれに合わせて変わりました。

valueに文字列を渡すと、警告が出て何も選ばれない

multiple を付けたまま、state を文字列(useState('ts'))にして value に渡すと、次のようになりました。

text
$ node run.mjs StringValue
  [console.error] The `value` prop supplied to <select> must be an array if `multiple` is true.
  最初:
    画面で選ばれている項目: []  select.value: ""
    state: "ts"
  TypeScript と Python を選んだあと:
    画面で選ばれている項目: []  select.value: ""
    state: "ts"

React 19.3.1 の開発用ビルドでは、multiple が true なら value は配列でなければならない、という警告がコンソールに出ました。state は "ts" なのに、画面では TypeScript も選ばれていません。TypeScript と Python を選んでも選択は外れ、state も "ts" のままでした。型チェックはこの書き方でも通ったので、multiple を付けたら state を配列にすることは、自分で気をつける必要があります。

stateを持たずに、送信のときにFormDataから読む

選んでいる間に画面のほかの部分を変える必要がなければ、state を持たずに、送信のときに値を読む方法もあります。最初に選んでおく値は、defaultValue に配列で渡します。公式リファレンスの、複数選択の説明にも、multiple={true} で defaultValue を指定するときは配列にすると書かれています。

tsx
function handleSubmit(e: FormEvent<HTMLFormElement>) {
  e.preventDefault();
  const formData = new FormData(e.currentTarget);
  setResult([
    `get: ${JSON.stringify(formData.get('langs'))}`,
    `getAll: ${JSON.stringify(formData.getAll('langs'))}`,
    `fromEntries: ${JSON.stringify(Object.fromEntries(formData))}`,
  ].join(' / '));
}

// JSX の中
<select name="langs" multiple defaultValue={['ts', 'go']} size={4}>

FormData からの読み方を3つ比べました。

text
$ node run.mjs Uncontrolled
  最初:
    画面で選ばれている項目: [TypeScript, Go]  select.value: "ts"
    
  そのまま送信したあと:
    画面で選ばれている項目: [TypeScript, Go]  select.value: "ts"
    get: "ts" / getAll: ["ts","go"] / fromEntries: {"langs":"go"}
  Python・Go・Rust に変えて送信したあと:
    画面で選ばれている項目: [Python, Go, Rust]  select.value: "py"
    get: "py" / getAll: ["py","go","rs"] / fromEntries: {"langs":"rs"}

最初は送信前なので、結果の行は空です。

選ばれている値がすべて取れたのは、getAll だけでした。get は最初の1つ、Object.fromEntries は最後の1つだけです。公式リファレンスの、送信時に値を読む例でも、複数選択の値は、選んだ値ごとに別々の名前と値の組として FormData に入ると説明されています。

注意

Object.fromEntries で値が欠けても、エラーは出ません。送ったデータが足りないことに気づきにくいので、複数選択の欄は getAll で読んでください。

​Posted by 86