`props.dangerouslySetInnerHTML` must be in the form `{__html: ...}`. Please visit https://reactjs.org/link/dangerously-set-inner-html for more information.
dangerouslySetInnerHTML a primit direct un text HTML. Prop-ul așteaptă un obiect cu cheia __html (două liniuțe jos): dangerouslySetInnerHTML={{ __html: descriere }}. Folosește-l doar pentru HTML de încredere sau curățat.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
dangerouslySetInnerHTML este echivalentul React pentru element.innerHTML: pune un text HTML direct în element, fără ca React să-l transforme în text sigur. Numele e lung și „periculos” intenționat, iar forma cu obiect { __html: ... } este încă un obstacol pus special, ca să nu-l folosești din greșeală.
Dacă scrii dangerouslySetInnerHTML={descriere} sau dangerouslySetInnerHTML="<b>...</b>", React aruncă această eroare și componenta nu se afișează. Corect este un obiect: dangerouslySetInnerHTML={{ __html: descriere }}. Cheia are două liniuțe jos.
Este o eroare (nu un avertisment), deci oprește randarea. Atenție la securitate: dacă HTML-ul vine de la utilizatori, curăță-l (de exemplu cu DOMPurify), altfel deschizi poarta pentru atacuri XSS.
De ce apare: cauzele frecvente
1Text pus direct
<div dangerouslySetInnerHTML={produs.descriere} /><div dangerouslySetInnerHTML={{ __html: produs.descriere }} />Prop-ul așteaptă un obiect cu cheia __html, nu textul HTML direct.
2Cheia scrisă greșit
<div dangerouslySetInnerHTML={{ html: descriere }} /><div dangerouslySetInnerHTML={{ __html: descriere }} />Cheia este exact __html, cu două liniuțe jos în față.
Repară eroarea, direct în pagină
Componenta de mai jos afișează descrierea unui produs, care vine ca HTML din magazin, dar dă eroarea „props.dangerouslySetInnerHTML must be in the form {__html: ...}”. Repar-o ca în #descriere să apară cuvântul „Nou” îngroșat (un element b), urmat de textul descrierii.
const produs = {
nume: "Lampă de birou",
descriere: "<b>Nou</b> Lumină caldă, reglabilă.",
};
export default function App() {
return (
<article>
<h2>{produs.nume}</h2>
<div id="descriere" dangerouslySetInnerHTML={produs.descriere} />
</article>
);
}Indiciu
Prop-ul primește un obiect cu cheia __html.
Reparația
const produs = {
nume: "Lampă de birou",
descriere: "<b>Nou</b> Lumină caldă, reglabilă.",
};
export default function App() {
return (
<article>
<h2>{produs.nume}</h2>
<div id="descriere" dangerouslySetInnerHTML={{ __html: produs.descriere }} />
</article>
);
}De ce merge
React cere ca HTML-ul „periculos” să fie împachetat într-un obiect cu cheia __html. Este o barieră pusă intenționat, ca nimeni să nu insereze HTML din greșeală. Un text pus direct nu respectă forma, deci React aruncă eroarea și nu randează componenta.
Cu {{ __html: produs.descriere }}, React pune textul ca innerHTML al div-ului, iar browserul îl interpretează: <b>Nou</b> devine un element îngroșat. Folosește asta doar pentru HTML în care ai încredere.
Alte forme ale mesajului
Error: `props.dangerouslySetInnerHTML` must be in the form `{__html: ...}`. Please visit https://reactjs.org/link/dangerously-set-inner-html for more information.Invariant Violation: `props.dangerouslySetInnerHTML` must be in the form `{__html: ...}`.
Cum o eviți pe viitor
- Folosește
dangerouslySetInnerHTMLdoar când chiar ai HTML de afișat (de exemplu conținut dintr-un CMS); pentru text obișnuit,{text}e suficient. - Scrie-l mereu cu acolade duble:
{{ __html: continut }}. - Curăță HTML-ul venit de la utilizatori înainte de afișare.
- Pune elementul fără copii: tagul trebuie să fie gol sau self-closing.
Întrebări frecvente
De ce nu pot pune pur și simplu {descriere} în div?
Poți, dar React îl afișează ca text: vei vedea <b>Nou</b> literal în pagină. React face asta intenționat, ca HTML-ul din date să nu poată executa cod.
E sigur dacă HTML-ul vine din backend-ul meu?
Doar dacă nimeni din afară nu poate introduce acel HTML. Dacă textul a fost scris vreodată de utilizatori (comentarii, recenzii), curăță-l înainte de afișare.
Erori înrudite
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. Objects are not valid as a React child (found: object with keys {nume, email}). If you meant to render a collection of children, use an array instead. Ai pus un obiect întreg între acolade în JSX, iar React nu știe să-l afișeze. Afișează o proprietate a lui ({utilizator.nume}), transformă-l în text sau, la un tablou de obiecte, folosește map. Warning: A future version of React will block javascript: URLs as a security precaution. Use event handlers instead if you can. If you need to generate unsafe HTML try using dangerouslySetInnerHTML instead. React was passed "javascript:void(0)". Ai pus un href="javascript:..." (de obicei javascript:void(0)) pe un link. React avertizează că va bloca astfel de adrese din motive de securitate. Pentru o acțiune folosește un <button> cu onClick; pentru un link real pune adresa reală în href. Î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.
