Reactで、複数選択できるselectの値をstateで扱う方法
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 と表示名の組にしました。
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 に文字列の配列を渡します。
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 になっているものです。
$ 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 の関数だけです(ボタンは付けていません)。
function handleChange(e: ChangeEvent<HTMLSelectElement>) {
setLangs([e.target.value]);
}
MDN の value の説明のとおり、select の value は、選ばれている option のうち最初のものの値です。そのため state には、いつも1つしか入りません。
同じ順に操作した記録です。
$ 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"] になる](https://neko-note.org/wp-content/uploads/2026/11/react-select-multiple-multiple-select-compare.gif)
①は、Ctrl を押しながら Go や Rust をクリックしても、TypeScript だけが選ばれたままです。②は、クリックするたびに選ばれている項目が増え、state も同じ配列になります。
「すべて選択」と「すべて解除」は、stateを書き換えるだけ
state で選択を持っていれば、ボタンから選択を変えるのは簡単です。上の MultiSelect の2つのボタンは、それぞれ state に全部の値の配列と、空の配列を入れているだけです。
node run.mjs MultiSelect の続きで、2つのボタンを押したときの記録です。
「すべて選択」を押したあと:
画面で選ばれている項目: [TypeScript, Python, Go, Rust] select.value: "ts"
state: ["ts","py","go","rs"]
「すべて解除」を押したあと:
画面で選ばれている項目: [] select.value: ""
state: []
state を変えると、画面の選択もそれに合わせて変わりました。
valueに文字列を渡すと、警告が出て何も選ばれない
multiple を付けたまま、state を文字列(useState('ts'))にして value に渡すと、次のようになりました。
$ 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 を指定するときは配列にすると書かれています。
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つ比べました。
$ 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 で読んでください。





