...
Eroare React · Sintaxă JSX și compilare

Adjacent JSX elements must be wrapped in an enclosing tag. Did you want a JSX fragment <>...</>?

Pe scurt

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

Greșit
JSX
return (
  <h1>Coșul tău</h1>
  <p>Total: 120 lei</p>
);
Corect
JSX
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

Greșit
JSX
{comenzi.map((c) => (
  <dt>{c.cod}</dt>
  <dd>{c.total} lei</dd>
))}
Corect
JSX
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

Greșit
JSX
return (
  <main>Produse</main>
)
<footer>Contact</footer>
Corect
JSX
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ă tu

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ă.

Codul care dă eroarea
JSX
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.

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 un div î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

← 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.