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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un câmp cu value={nume} este controlat: React se asigură că ce vezi în câmp este mereu exact valoarea din state. Când utilizatorul tastează, React readuce câmpul la nume. Dacă nu există un onChange care să actualizeze nume, valoarea nu se schimbă niciodată, iar câmpul pare blocat.
React observă situația și te avertizează, iar mesajul îți propune trei variante: adaugă onChange (câmp controlat, cel mai des), folosește defaultValue (câmp necontrolat, citit la trimitere) sau marchează câmpul readOnly dacă chiar trebuie să fie doar pentru citire.
Pentru checkbox-uri mesajul este echivalent, cu checked în loc de value („You provided a checked prop to a form field without an onChange handler”).
De ce apare: cauzele frecvente
1value fără onChange
const [nume, setNume] = useState("");
<input value={nume} />const [nume, setNume] = useState("");
<input value={nume} onChange={(e) => setNume(e.target.value)} />Fiecare tastă apelează setNume, iar React afișează noua valoare.
2Valoare inițială pentru un câmp necontrolat
<input value="București" /><input defaultValue="București" />defaultValue dă doar valoarea de pornire; apoi câmpul se descurcă singur.
3Checkbox cu checked fără onChange
<input type="checkbox" checked={accept} /><input type="checkbox" checked={accept} onChange={(e) => setAccept(e.target.checked)} />La checkbox se citește e.target.checked, nu value.
Repară eroarea, direct în pagină
Câmpul #nume de mai jos are value legat de state, dar nu are onChange: consola arată avertismentul, iar textul scris dispare. Repară-l ca, după ce scrii „Ana”, paragraful #salut să afișeze „Salut, Ana!”.
import { useState } from "react";
export default function App() {
const [nume, setNume] = useState("");
return (
<div>
<input id="nume" value={nume} placeholder="Numele tău" />
<p id="salut">Salut, {nume || "vizitatorule"}!</p>
</div>
);
}Indiciu
Câmpul are nevoie de un handler care actualizează state-ul.
Reparația
import { useState } from "react";
export default function App() {
const [nume, setNume] = useState("");
return (
<div>
<input id="nume" value={nume} onChange={(e) => setNume(e.target.value)} placeholder="Numele tău" />
<p id="salut">Salut, {nume || "vizitatorule"}!</p>
</div>
);
}De ce merge
Cu value={nume}, React decide conținutul câmpului la fiecare randare. Când tastezi, React readuce câmpul la nume, iar fără onChange state-ul nu se schimbă niciodată, deci textul dispare și salutul rămâne „vizitatorule”.
onChange={(e) => setNume(e.target.value)} închide cercul: fiecare tastă actualizează state-ul, componenta se randează din nou, iar câmpul și salutul arată noua valoare.
Alte forme ale mesajului
Warning: You provided a `checked` prop to a form field without an `onChange` handler. This will render a read-only field. If the field should be mutable use `defaultChecked`. Otherwise, set either `onChange` or `readOnly`.Warning: You provided a `value` prop to a form field without an `onChange` handler.
Cum o eviți pe viitor
- Ține perechea împreună: când scrii
value=, scrie imediat șionChange=. - Pentru formulare mari folosește un singur handler care citește
e.target.name. - Alege conștient: controlat (
value+onChange) când ai nevoie de valoare la fiecare tastă, necontrolat (defaultValue+refsauFormData) când îți trebuie doar la trimitere.
Întrebări frecvente
De ce nu pot scrie nimic în câmp?
Pentru că React readuce câmpul la valoarea din state după fiecare tastă, iar fără onChange state-ul rămâne același. Nu e un bug al browserului, ci tocmai ce înseamnă un câmp controlat.
Care e diferența dintre value și defaultValue?
value face câmpul controlat de React la fiecare randare. defaultValue setează doar valoarea inițială, după care câmpul își ține singur conținutul, ca în HTML.
Erori înrudite
Warning: A component is changing an uncontrolled input to be controlled. This is likely caused by the value changing from undefined to a defined value, which should not happen. Decide between using a controlled or uncontrolled input element for the lifetime of the component. Câmpul a pornit cu value={undefined} (necontrolat) și apoi a primit un text (controlat). Dă state-ului o valoare inițială: useState("") sau, pentru un formular, useState({ email: "", parola: "" }). ReferenceError: e is not defined Folosești e.target.value într-un handler care nu primește parametrul e: onChange={() => setNume(e.target.value)}. Declară parametrul: onChange={(e) => setNume(e.target.value)}. Warning: Invalid event handler property `onclick`. Did you mean `onClick`? Ai scris evenimentul cu litere mici, ca în HTML (onclick, onchange). În React evenimentele se scriu în camelCase și primesc o funcție: onClick={adauga}, onChange={...}. Î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.
