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

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`.

Pe scurt

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

Greșit
JSX
const [nume, setNume] = useState("");
<input value={nume} />
Corect
JSX
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

Greșit
JSX
<input value="București" />
Corect
JSX
<input defaultValue="București" />

defaultValue dă doar valoarea de pornire; apoi câmpul se descurcă singur.

3Checkbox cu checked fără onChange

Greșit
JSX
<input type="checkbox" checked={accept} />
Corect
JSX
<input type="checkbox" checked={accept} onChange={(e) => setAccept(e.target.checked)} />

La checkbox se citește e.target.checked, nu value.

Repară tu

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!”.

Codul care dă eroarea
JSX
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.

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 și onChange=.
  • 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 + ref sau FormData) 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

← 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.