Comments inside children section of tag should be placed inside braces
Ai scris un comentariu JavaScript (// sau /* */) direct între taguri JSX, iar React îl afișează ca text în pagină. Regula ESLint react/jsx-no-comment-textnodes te avertizează. În JSX, comentariile se scriu între acolade: {/* comentariu */}.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Între tagurile JSX nu mai ești în JavaScript, ci în text. Tot ce scrii acolo, inclusiv // antet sau /* TODO */, devine conținut al elementului și apare în pagină exact așa, cu barele oblice cu tot.
Mesajul vine de la ESLint, regula react/jsx-no-comment-textnodes (inclusă în plugin:react/recommended și în configurațiile Next.js și Create React App). Ea observă un text care arată ca un comentariu și îți spune să-l pui între acolade: în interiorul { } ești din nou în JavaScript, iar {/* ... */} este o expresie goală care nu afișează nimic.
Atenție: {// comentariu} pe o singură linie nu merge, pentru că // comentează și acolada de închidere. Folosește mereu forma {/* ... */}. Pe atribute (în interiorul tagului de deschidere) poți folosi comentarii normale, pentru că acolo ești în JavaScript.
De ce apare: cauzele frecvente
1Comentariu cu // între taguri
<header>
// logo și meniu
<h1>Magazin</h1>
</header><header>
{/* logo și meniu */}
<h1>Magazin</h1>
</header>Linia // logo și meniu este text pentru JSX și apare în pagină; în acolade devine un comentariu adevărat.
2Cod dezactivat cu /* */
<ul>
/* <li>Reduceri</li> */
<li>Noutăți</li>
</ul><ul>
{/* <li>Reduceri</li> */}
<li>Noutăți</li>
</ul>Fără acolade, /* și */ sunt simple caractere de text, iar elementul dinăuntru tot se randează.
3Comentariu // în acolade pe o singură linie
<p>
{// prețul final}
{pret} lei
</p><p>
{/* prețul final */}
{pret} lei
</p>// comentează tot restul liniei, inclusiv }, așa că acolada rămâne deschisă și compilarea pică.
Repară eroarea, direct în pagină
Antetul de mai jos afișează în pagină și comentariile: „// logo și meniu”, iar ESLint spune „Comments inside children section of tag should be placed inside braces”. Repară-l ca #antet să conțină doar textul „Magazin” și meniul, iar lista să aibă doar elementele Noutăți și Contact.
export default function App() {
return (
<div>
<header id="antet">
// logo și meniu
<h1>Magazin</h1>
</header>
<ul>
/* <li>Reduceri</li> */
<li>Noutăți</li>
<li>Contact</li>
</ul>
</div>
);
}Indiciu
Pune fiecare comentariu în forma {/* ... */}.
Reparația
export default function App() {
return (
<div>
<header id="antet">
{/* logo și meniu */}
<h1>Magazin</h1>
</header>
<ul>
{/* <li>Reduceri</li> */}
<li>Noutăți</li>
<li>Contact</li>
</ul>
</div>
);
}De ce merge
Între taguri, JSX tratează orice caractere ca text, așa că // logo și meniu apărea în antet, iar /* și */ apăreau în listă, cu elementul Reduceri randat între ele.
În acolade ești din nou în JavaScript, iar {/* ... */} este o expresie goală: nu produce niciun nod în pagină. Antetul rămâne doar cu titlul, iar lista doar cu cele două elemente active.
Alte forme ale mesajului
Comments inside children section of tag should be placed inside braces react/jsx-no-comment-textnodeserror Comments inside children section of tag should be placed inside braces react/jsx-no-comment-textnodes
Cum o eviți pe viitor
- În JSX folosește scurtătura editorului pentru comentarii (Ctrl+/ sau Cmd+/): în fișierele .jsx, VS Code pune automat
{/* */}. - Lasă ESLint activ în editor, ca să vezi regula
react/jsx-no-comment-textnodesimediat. - Când vrei să ascunzi temporar un element, pune-l în
{/* ... */}sau într-o condiție ({false && <li>...</li>}). - Uită-te în pagină după modificări: un
//vizibil în interfață e semnul acestei greșeli.
Întrebări frecvente
De ce nu dă eroare de compilare, dacă e o greșeală?
Pentru JSX, textul // antet este perfect valid: e doar text. De aceea regula vine de la ESLint, care ghicește că ai vrut un comentariu, nu de la compilator.
Pot pune comentarii în atributele unui tag?
Da. Între <div și > ești în JavaScript, așa că poți scrie {/* */} sau chiar // pe linii separate, între atribute.
Erori înrudite
JSX attributes must only be assigned a non-empty expression. Un atribut JSX are acolade goale, de exemplu title={}. Între acolade trebuie să fie o expresie: o variabilă, un text, un număr sau o funcție. Scrie valoarea sau șterge atributul. SyntaxError: Unexpected token Între acoladele din JSX ai pus o instrucțiune (if, for, o declarație) sau un comentariu HTML. Acolo merg doar expresii: folosește condiție && <p>...</p>, operatorul ? : sau map. `'` can be escaped with `'`, `‘`, `'`, `’`. Regula ESLint react/no-unescaped-entities nu acceptă caracterele ', ", > și } scrise direct în textul JSX. Înlocuiește-le cu entitatea HTML propusă (', ", >, }) sau pune textul într-o expresie: {"Rock'n'roll"}. Î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.
