Warning: A component is `contentEditable` and contains `children` managed by React. It is now your responsibility to guarantee that none of those nodes are unexpectedly modified or duplicated. This is probably not intentional.
Ai pus contentEditable pe un element care are și copii randați de React. Browserul și React modifică atunci același DOM: textul se poate dubla, iar cursorul sare la început. Pentru text folosește un <textarea> controlat; altfel lasă elementul fără copii React sau pune suppressContentEditableWarning doar la conținut static.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Cu contentEditable, browserul lasă utilizatorul să modifice direct nodurile DOM ale elementului: adaugă, șterge și sparge noduri text la fiecare tastă. React, la rândul lui, crede că el deține acele noduri (copiii pe care i-ai scris în JSX) și le actualizează la fiecare randare.
Când amândoi lucrează pe același DOM, apar probleme greu de prins: text dublat, litere pierdute, cursorul care sare la început după fiecare randare sau erori de tipul „Failed to execute 'removeChild'”. De aceea React avertizează din prima randare.
Variante corecte:
- pentru un câmp de text simplu sau pe mai multe rânduri, folosește
<textarea>controlat (value+onChange): React și browserul nu se mai calcă pe picioare; - pentru un editor bogat (bold, liste), folosește o bibliotecă specializată (Lexical, Slate, TipTap), care gestionează DOM-ul în locul lui React;
- dacă textul inițial e static și nu-l mai randezi din state, poți pune
suppressContentEditableWarning, asumându-ți că React nu va mai atinge acel conținut.
De ce apare: cauzele frecvente
1Notă editabilă cu text din state
<div contentEditable onInput={(e) => setNota(e.target.textContent)}>
{nota}
</div><textarea value={nota} onChange={(e) => setNota(e.target.value)} />Textarea-ul controlat are o singură sursă a valorii (state), iar React o actualizează fără să rescrie nodurile editate de browser.
2Titlu editabil cu conținut static
<h1 contentEditable>Titlul documentului</h1><h1 contentEditable suppressContentEditableWarning>
Titlul documentului
</h1>Textul inițial nu mai e schimbat de React, deci avertismentul poate fi oprit conștient.
3Editor de text bogat scris de mână
<div contentEditable>
<b>{titlu}</b>
<p>{continut}</p>
</div>// folosește un editor specializat, de exemplu Lexical sau TipTap,
// care gestionează singur DOM-ul editabilEditoarele specializate sunt construite tocmai pentru a evita conflictul dintre React și modificările browserului.
Repară eroarea, direct în pagină
Nota de mai jos folosește un div cu contentEditable care afișează textul din state, iar consola arată „A component is contentEditable and contains children managed by React”. Înlocuiește-l cu un textarea controlat cu id-ul nota, ca după ce scrii „Lapte și pâine”, #caractere să afișeze „14 caractere”.
import { useState } from "react";
export default function App() {
const [nota, setNota] = useState("");
return (
<div>
<div id="nota" contentEditable onInput={(e) => setNota(e.currentTarget.textContent)}>
{nota}
</div>
<p id="caractere">{nota.length} caractere</p>
</div>
);
}Indiciu
<textarea id="nota" value={nota} onChange={(e) => setNota(e.target.value)} />
Reparația
import { useState } from "react";
export default function App() {
const [nota, setNota] = useState("");
return (
<div>
<textarea id="nota" value={nota} onChange={(e) => setNota(e.target.value)} />
<p id="caractere">{nota.length} caractere</p>
</div>
);
}De ce merge
contentEditable lăsa browserul să modifice direct nodurile din div, în timp ce React randa în ele textul din state. Doi „proprietari” ai aceluiași DOM duc la cursor care sare și text dublat, de aceea React a avertizat.
Un textarea controlat are o singură sursă a valorii: starea nota. Browserul trimite fiecare modificare prin onChange, iar React actualizează valoarea câmpului fără să rescrie noduri, deci numărul de caractere e mereu corect.
Alte forme ale mesajului
Warning: A component is `contentEditable` and contains `children` managed by React.NotFoundError: Failed to execute 'removeChild' on 'Node': The node to be removed is not a child of this node.NotFoundError: Failed to execute 'insertBefore' on 'Node': The node before which the new node is to be inserted is not a child of this node.
Cum o eviți pe viitor
- Pentru introducere de text, folosește
inputsautextareacontrolate, nucontentEditable. - Dacă folosești
contentEditable, nu-i da copii randați din state. - Pentru formatare (bold, liste, linkuri), alege un editor specializat în loc să construiești unul.
suppressContentEditableWarningpune-l doar când ești sigur că React nu mai modifică acel conținut.
Întrebări frecvente
De ce sare cursorul la început când scriu?
Pentru că la fiecare tastă schimbi starea, iar React rescrie conținutul elementului cu noul text. Browserul pierde poziția cursorului și o pune la început.
suppressContentEditableWarning rezolvă problema?
Doar ascunde avertismentul. Dacă React încă randează copiii din state, problemele de cursor și text dublat rămân. E potrivit doar pentru conținut inițial static.
Erori înrudite
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. Warning: Use the `defaultValue` or `value` props instead of setting children on <textarea>. Ai pus text între <textarea>...</textarea>, ca în HTML. În React textul dintr-un textarea se dă prin value (cu onChange, câmp controlat) sau defaultValue (doar valoarea de pornire). Închide tagul gol: <textarea value={mesaj} onChange={...} />. Can only set one of `children` or `props.dangerouslySetInnerHTML`. Elementul are și dangerouslySetInnerHTML, și conținut între taguri. React nu știe pe care să-l pună, deci aruncă eroarea. Lasă elementul cu dangerouslySetInnerHTML gol (<div dangerouslySetInnerHTML={...} />) și mută celălalt conținut într-un element vecin. Î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.
