Adjacent JSX elements must be wrapped in an enclosing tag. Did you want a JSX fragment <>...</>?
Componenta returnează două sau mai multe elemente JSX unul lângă altul, fără un părinte comun. O funcție poate întoarce o singură valoare, deci le pui într-un fragment <>...</> sau într-un <div>.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la compilatorul JSX (Babel), nu de la React: codul nici nu ajunge să ruleze. Adjacent JSX elements înseamnă „elemente JSX alăturate”, iar restul propoziției îți spune soluția: învelește-le într-un tag comun sau într-un fragment.
Motivul ține de felul în care se traduce JSX-ul. <h1>Salut</h1> devine un apel React.createElement("h1", null, "Salut"), adică o singură valoare. Două elemente puse unul după altul în return (...) ar fi două valori întoarse deodată, ceea ce în JavaScript nu se poate.
Eroarea apare des când adaugi încă un paragraf sub un titlu existent sau când pui două rânduri de tabel într-un map. Linia și coloana din mesaj arată de obicei începutul celui de-al doilea element, adică locul unde compilatorul și-a dat seama că mai urmează ceva după primul element complet.
De ce apare: cauzele frecvente
1Două elemente în același return
return (
<h1>Coșul tău</h1>
<p>Total: 120 lei</p>
);return (
<>
<h1>Coșul tău</h1>
<p>Total: 120 lei</p>
</>
);Fragmentul <>...</> grupează elementele fără să adauge un nod în pagină, deci componenta întoarce o singură valoare.
2Mai multe elemente în callback-ul din map
{comenzi.map((c) => (
<dt>{c.cod}</dt>
<dd>{c.total} lei</dd>
))}import { Fragment } from "react";
{comenzi.map((c) => (
<Fragment key={c.id}>
<dt>{c.cod}</dt>
<dd>{c.total} lei</dd>
</Fragment>
))}Și funcția din map trebuie să întoarcă un singur element. Forma scurtă <> nu acceptă key, așa că într-o listă folosești <Fragment key=...>.
3Un element pus după paranteza din return
return (
<main>Produse</main>
)
<footer>Contact</footer>return (
<>
<main>Produse</main>
<footer>Contact</footer>
</>
);Tot ce randează componenta trebuie să fie în interiorul aceluiași element rădăcină din return.
Repară eroarea, direct în pagină
Componenta de mai jos nu compilează: dă eroarea „Adjacent JSX elements must be wrapped in an enclosing tag”. Repar-o ca să afișeze titlul #titlu („Coșul tău”) și, sub el, paragraful #total („Total: 120 lei”), fără să adaugi un div în plus în pagină.
export default function App() {
return (
<h1 id="titlu">Coșul tău</h1>
<p id="total">Total: 120 lei</p>
);
}Indiciu
Un fragment <>...</> grupează elementele fără să creeze un nod nou.
Reparația
export default function App() {
return (
<>
<h1 id="titlu">Coșul tău</h1>
<p id="total">Total: 120 lei</p>
</>
);
}De ce merge
JSX-ul se transformă în apeluri React.createElement(...), iar fiecare apel este o singură valoare. Un return poate întoarce o singură valoare, deci două elemente alăturate nu au cum să fie întoarse deodată, iar compilatorul se oprește înainte de rulare.
Fragmentul <>...</> este un părinte „invizibil”: componenta întoarce acum un singur element, dar în pagină cele două noduri ajung direct în #root, fără un div intermediar. Un div ar fi mers și el, dar adaugă un nod care uneori strică stilurile.
Alte forme ale mesajului
SyntaxError: Adjacent JSX elements must be wrapped in an enclosing tag. Did you want a JSX fragment <>...</>? (4:4)JSX expressions must have one parent element.
Cum o eviți pe viitor
- Pornește fiecare componentă cu un singur element rădăcină și adaugă conținutul înăuntrul lui.
- Folosește
<>...</>când nu vrei undivîn plus (de exemplu în tabele, liste sau layout-uri flex). - În
map, dacă un rând are mai multe elemente, învelește-le în<Fragment key={...}>. - Un editor cu formatare automată (Prettier) îți arată imediat structura greșită: indentarea se strică exact unde lipsește părintele.
Întrebări frecvente
Ce diferență e între <> și <div>?
Un div apare în pagină ca nod real și poate strica un layout flex sau grid, sau un tabel (<tr> nu acceptă div între el și <td>). Fragmentul <>...</> nu produce niciun nod: copiii lui ajung direct în părintele componentei.
De ce nu pot întoarce un tablou de elemente?
Poți: return [<h1 key="t">Titlu</h1>, <p key="p">Text</p>]; funcționează, dar fiecare element are nevoie de key și codul e mai greu de citit. Fragmentul face același lucru fără chei.
Eroarea apare la import, nu în componenta mea. De ce?
Linia din mesaj e cea a fișierului care nu compilează. Dacă eroarea e într-un fișier importat (de exemplu Card.jsx), toată aplicația se oprește, pentru că modulul acela nu poate fi încărcat.
Erori înrudite
Expected corresponding JSX closing tag for <p>. Un tag JSX este închis cu alt nume decât cel cu care a fost deschis, de exemplu <p> închis cu </span>. Închide fiecare element cu tagul lui, în ordinea inversă deschiderii. Unterminated JSX contents. Un element JSX a rămas deschis până la finalul blocului, cel mai des un tag gol scris ca în HTML (<input>, <img>, <br>) fără /. În JSX toate elementele se închid: <input />, <br />. 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. Î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.
