Warning: The `value` prop supplied to <select> must be an array if `multiple` is true.
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("")sauuseState(null); - în
onChangeciteștie.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
const [culori, setCulori] = useState("");
<select multiple value={culori} onChange={...}>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
onChange={(e) => setCulori(e.target.value)}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ă 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”.
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.
Reparația
import { useState } from "react";
export default function App() {
const [culori, setCulori] = useState(["rosu"]);
return (
<div>
<select
id="culori"
multiple
value={culori}
onChange={(e) => setCulori(Array.from(e.target.selectedOptions, (o) => o.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>
);
}De ce merge
Cu multiple, valoarea unui select este lista opțiunilor alese. Un text simplu nu se potrivește, iar React avertizează; în plus, culori.join nu există pe un text, deci componenta se oprea cu o eroare.
useState(["rosu"]) pornește cu o listă de o culoare, iar Array.from(e.target.selectedOptions, (o) => o.value) construiește în onChange lista tuturor opțiunilor alese. join le afișează despărțite prin virgulă.
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
Warning: Use the `defaultValue` or `value` props on <select> instead of setting `selected` on <option>. Ai marcat opțiunea aleasă cu selected pe un <option>, ca în HTML. În React alegerea se face pe <select>: value={oras} cu onChange pentru un câmp controlat, sau defaultValue="cluj" pentru unul necontrolat. Warning: You provided a `value` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultValue`. Otherwise, set either `onChange` or `readOnly`. Câmpul are value legat de state, dar fără onChange, deci React îl blochează: orice scrii dispare. Adaugă onChange={(e) => setNume(e.target.value)} sau folosește defaultValue dacă nu ai nevoie de state. TypeError: produse.map is not a function Variabila pe care apelezi map există, dar nu este un tablou: de obicei e obiectul întreg primit de la API ({ produse: [...] }) sau un string. Pune în state tabloul din interiorul răspunsului, de exemplu data.produse. Î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.
