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

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.

Pe scurt

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: "" }).

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

Ce înseamnă

React împarte câmpurile în două feluri: necontrolate (fără value, sau cu value={undefined}), unde browserul ține textul, și controlate (value cu un string), unde îl ține React. Un câmp trebuie să rămână de același fel toată viața lui.

Mesajul spune chiar cauza: valoarea s-a schimbat din undefined într-o valoare definită. Se întâmplă când state-ul pornește gol: useState() sau un obiect fără câmpul respectiv (useState({}) și value={form.email}). La prima randare value este undefined, deci câmpul e necontrolat; la prima tastă devine string, deci controlat.

Inversul are propriul mesaj („changing a controlled input to be uncontrolled”), de obicei când un setForm uită să păstreze celelalte câmpuri, iar unul devine undefined.

De ce apare: cauzele frecvente

1State pornit fără valoare

Greșit
JSX
const [email, setEmail] = useState();
<input value={email} onChange={(e) => setEmail(e.target.value)} />
Corect
JSX
const [email, setEmail] = useState("");
<input value={email} onChange={(e) => setEmail(e.target.value)} />

Cu "" câmpul este controlat încă de la prima randare.

2Obiect de formular fără câmpuri

Greșit
JSX
const [form, setForm] = useState({});
<input name="email" value={form.email} onChange={schimba} />
Corect
JSX
const [form, setForm] = useState({ email: "", parola: "" });
<input name="email" value={form.email} onChange={schimba} />

Fiecare câmp are de la început un string, nu undefined.

3Actualizare care pierde celelalte câmpuri

Greșit
JSX
setForm({ [e.target.name]: e.target.value });
Corect
JSX
setForm((f) => ({ ...f, [e.target.name]: e.target.value }));

Fără spread, celelalte câmpuri dispar din obiect și devin undefined.

Repară tu

Repară eroarea, direct în pagină

Formularul de autentificare de mai jos pornește cu useState({}), iar la prima tastă consola arată „A component is changing an uncontrolled input to be controlled”. Dă state-ului valori inițiale pentru ambele câmpuri, ca, după ce scrii emailul „ana@exemplu.ro” în #email, paragraful #rezumat să afișeze „Email: ana@exemplu.ro”.

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

export default function App() {
  const [form, setForm] = useState({});

  function schimba(e) {
    setForm((f) => ({ ...f, [e.target.name]: e.target.value }));
  }

  return (
    <form>
      <input id="email" name="email" value={form.email} onChange={schimba} />
      <input id="parola" name="parola" type="password" value={form.parola} onChange={schimba} />
      <p id="rezumat">Email: {form.email}</p>
    </form>
  );
}
Indiciu

Fiecare câmp are nevoie de un string inițial.

Alte forme ale mesajului

  • Warning: A component is changing a controlled input to be uncontrolled. This is likely caused by the value changing from a defined to undefined, which should not happen.
  • Warning: `value` prop on `input` should not be null. Consider using an empty string to clear the component or `undefined` for uncontrolled components.

Cum o eviți pe viitor

  • Dă mereu valori inițiale state-ului unui formular: "" pentru text, false pentru checkbox.
  • Când datele vin dintr-un API și pot avea câmpuri null, folosește value={date.telefon ?? ""}.
  • La actualizarea unui obiect de formular, păstrează restul câmpurilor cu ...f.

Întrebări frecvente

Formularul merge. Avertismentul contează?

Da: trecerea dintre cele două moduri poate pierde textul scris sau poziția cursorului și face comportamentul greu de prevăzut. Repararea e o singură valoare inițială.

Valoarea vine din API ca null. Ce fac?

value={null} produce un avertisment asemănător. Transformă la afișare: value={utilizator.telefon ?? ""}.

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.