...
Eroare React · Formulare și câmpuri controlate

Warning: The `value` prop supplied to <select> must be an array if `multiple` is true.

Pe scurt

Un <select multiple> primește în value un text sau un număr. Cu multiple, valoarea este lista opțiunilor alese, deci trebuie să fie un tablou: useState([]) și, în onChange, Array.from(e.target.selectedOptions, (o) => o.value).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un select obișnuit are o singură valoare (un text). Cu atributul multiple, utilizatorul poate alege mai multe opțiuni, deci valoarea select-ului devine o listă. React cere ca value (sau defaultValue) să fie atunci un tablou, de exemplu ["rosu", "albastru"].

Greșeala apare de obicei în două locuri:

  • state-ul pornește cu useState("") sau useState(null);
  • în onChange citești e.target.value, care la un select multiplu dă doar prima opțiune aleasă, ca text.

Mesajul are uneori și componenta („Check the render method of Filtre”). Valorile alese se citesc din e.target.selectedOptions, transformate în tablou.

De ce apare: cauzele frecvente

1State pornit cu un text

Greșit
JSX
const [culori, setCulori] = useState("");
<select multiple value={culori} onChange={...}>
Corect
JSX
const [culori, setCulori] = useState([]);
<select multiple value={culori} onChange={...}>

Lista de opțiuni alese pornește goală, ca tablou.

2onChange care citește e.target.value

Greșit
JSX
onChange={(e) => setCulori(e.target.value)}
Corect
JSX
onChange={(e) =>
  setCulori(Array.from(e.target.selectedOptions, (o) => o.value))
}

selectedOptions conține toate opțiunile alese; Array.from le transformă în tabloul de valori.

Repară tu

Repară eroarea, direct în pagină

Filtrul de culori de mai jos folosește un select multiple, dar consola arată „The value prop supplied to <select> must be an array if multiple is true”, iar lista de sub el nu apare. Repar-o ca, la început, culoarea „rosu” să fie aleasă, iar #alese să afișeze „Alese: rosu”.

Codul care dă eroarea
JSX
import { useState } from "react";

export default function App() {
  const [culori, setCulori] = useState("rosu");

  return (
    <div>
      <select id="culori" multiple value={culori} onChange={(e) => setCulori(e.target.value)}>
        <option value="rosu">Roșu</option>
        <option value="verde">Verde</option>
        <option value="albastru">Albastru</option>
      </select>
      <p id="alese">Alese: {culori.join(", ")}</p>
    </div>
  );
}
Indiciu

Pornește state-ul cu un tablou și citește selectedOptions în onChange.

Alte forme ale mesajului

  • Warning: The `value` prop supplied to <select> must be an array if `multiple` is true. Check the render method of `App`.
  • Warning: The `defaultValue` prop supplied to <select> must be an array if `multiple` is true.
  • Warning: The `value` prop supplied to <select> must be a scalar value if `multiple` is false.

Cum o eviți pe viitor

  • Pentru select multiple, pornește state-ul cu [] și păstrează-l mereu tablou.
  • Citește valorile cu Array.from(e.target.selectedOptions, (o) => o.value).
  • Pentru câteva opțiuni, o listă de checkbox-uri e adesea mai ușor de folosit decât un select multiplu, mai ales pe telefon.

Întrebări frecvente

Și invers? Am un tablou, dar fără multiple.

Primești avertismentul pereche: valoarea trebuie să fie „scalar” (un singur text) dacă multiple este false. Ori adaugi multiple, ori pui o singură valoare.

Cum aleg mai multe opțiuni cu mouse-ul?

Ții apăsat Ctrl (Cmd pe Mac) și dai click pe opțiuni. Mulți utilizatori nu știu asta, de aceea checkbox-urile sunt adesea mai clare.

Erori înrudite

← Toate erorile React

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață React de la zero, cu exerciții la fiecare lecție

Curs React: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.