Fragments should contain more than one child - otherwise, there’s no need for a Fragment at all.
Regula ESLint react/jsx-no-useless-fragment vede un <>...</> care conține un singur element (sau doar un text). Fragmentul nu face nimic acolo: întoarce direct elementul, de exemplu return <span>...</span>;
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un Fragment (<>...</>) are un singur rol: să grupeze mai multe elemente alăturate acolo unde JSX cere un singur părinte. Când în el e un singur copil, nu grupează nimic și poate fi scos fără nicio schimbare în pagină.
Regula react/jsx-no-useless-fragment din eslint-plugin-react raportează astfel de fragmente. De obicei rămân în cod după o refactorizare: componenta întorcea două elemente, ai șters unul, iar <> a rămas. Sau ai pus din obișnuință <> în jurul oricărui return.
Codul merge, deci e o problemă de claritate: fiecare nivel în plus face JSX-ul mai greu de citit. Aceeași regulă are și mesajul „Passing a fragment to an HTML element is useless”, pentru un <> pus direct ca singur copil al unui div sau p. Excepție: un fragment care împachetează o expresie, de exemplu <>{eticheta}</>, poate fi util ca să întorci un element valid; regula are opțiunea allowExpressions pentru asta.
De ce apare: cauzele frecvente
1Un singur element în fragment
return (
<>
<span className="pret">{valoare} lei</span>
</>
);return <span className="pret">{valoare} lei</span>;Elementul unic poate fi întors direct, fără niciun învelitor.
2Fragment rămas după refactorizare
return (
<>
<Card produs={p} />
</>
);return <Card produs={p} />;După ce ai șters al doilea element, fragmentul nu mai are rost.
3Fragment pus într-un element HTML
<p>
<>
Total: {total} lei
</>
</p><p>Total: {total} lei</p>Elementul p grupează deja conținutul; fragmentul din interior e inutil.
Repară eroarea, direct în pagină
Componenta Pret de mai jos întoarce un fragment <>...</> cu un singur span, iar ESLint raportează „Fragments should contain more than one child”. Scoate fragmentul și întoarce direct elementul, ca #produs să afișeze în continuare prețul „25 lei”.
function Pret({ valoare }) {
return (
<>
<span className="pret">{valoare} lei</span>
</>
);
}
export default function App() {
return (
<p id="produs">
Cană: <Pret valoare={25} />
</p>
);
}Indiciu
return <span className="pret">{valoare} lei</span>;
Reparația
function Pret({ valoare }) {
return <span className="pret">{valoare} lei</span>;
}
export default function App() {
return (
<p id="produs">
Cană: <Pret valoare={25} />
</p>
);
}De ce merge
Fragmentul conținea un singur element, deci nu grupa nimic: pagina arăta la fel cu sau fără el, iar ESLint l-a semnalat ca inutil.
Acum Pret întoarce direct span-ul. JSX-ul e mai scurt, iar prețul apare în același loc din paragraf.
Alte forme ale mesajului
Passing a fragment to an HTML element is useless.Fragments should contain more than one child - otherwise, there’s no need for a Fragment at all. react/jsx-no-useless-fragment
Cum o eviți pe viitor
- Folosește
<>...</>doar când întorci două sau mai multe elemente alăturate. - După ce ștergi elemente dintr-un
return, verifică dacă fragmentul mai e necesar. - Activează
react/jsx-no-useless-fragmentîn ESLint; are reparare automată cu--fix. - Nu pune fragmente direct în elemente HTML: elementul grupează deja copiii.
Întrebări frecvente
E vreo problemă de performanță?
Practic nu: fragmentul nu apare în DOM. Regula e despre cod mai simplu de citit.
Pot repara automat?
Da. npx eslint --fix scoate fragmentele inutile pentru tine, cu condiția ca regula să fie activă în configurație.
Erori înrudite
Warning: Invalid prop `className` supplied to `React.Fragment`. React.Fragment can only have `key` and `children` props. Ai pus un atribut (className, style, id, onClick) pe un Fragment sau pe <>...</>. Fragmentul nu ajunge în DOM, deci n-are unde să pună atributul și îl ignoră. Folosește un element real, de exemplu <div className="card">, sau pune atributul pe un copil. 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>. Do not pass children as props. Instead, nest children between the opening and closing tags. Regula ESLint react/no-children-prop îți spune că ai scris children ca atribut: <Panou children={<p>...</p>} />. Merge, dar nu e forma obișnuită. Pune conținutul între tagul de deschidere și cel de închidere: <Panou><p>...</p></Panou>. Î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.
