...
Eroare React · Ce poți afișa în JSX

Warning: Invalid prop `className` supplied to `React.Fragment`. React.Fragment can only have `key` and `children` props.

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un Fragment (<Fragment> sau <>...</>) grupează elemente fără să adauge nimic în pagină. E util când o componentă trebuie să întoarcă mai multe elemente alăturate, dar nu vrei un div în plus.

Tocmai pentru că nu există în DOM, un Fragment nu poate avea clasă, stil, id sau evenimente. React acceptă pe el doar key (în liste) și children. Orice alt atribut este ignorat, iar în dezvoltare primești avertismentul, cu numele atributului (className).

Efectul vizibil: stilurile pe care le așteptai pe .card nu se aplică, iar selectorii CSS sau testele care caută .card nu găsesc nimic. Pe forma scurtă <> nu poți scrie deloc atribute, deci problema apare de obicei când ai înlocuit un div cu Fragment și ai uitat atributele pe el.

De ce apare: cauzele frecvente

1Clasă pe Fragment

Greșit
JSX
<Fragment className="card">
  <h3>{titlu}</h3>
</Fragment>
Corect
JSX
<div className="card">
  <h3>{titlu}</h3>
</div>

Ai nevoie de un element real ca să ai unde pune clasa.

2Eveniment pe Fragment

Greșit
JSX
<Fragment onClick={deschide}>
  <img src={poza} alt="" />
  <p>{nume}</p>
</Fragment>
Corect
JSX
<button type="button" onClick={deschide}>
  <img src={poza} alt="" />
  <p>{nume}</p>
</button>

Evenimentele au nevoie de un nod DOM care să le primească.

3Fragment în listă, cu key

Greșit
JSX
{randuri.map((r) => (
  <>
    <dt>{r.cheie}</dt>
    <dd>{r.valoare}</dd>
  </>
))}
Corect
JSX
{randuri.map((r) => (
  <Fragment key={r.cheie}>
    <dt>{r.cheie}</dt>
    <dd>{r.valoare}</dd>
  </Fragment>
))}

key este singurul atribut acceptat, și pentru el trebuie forma lungă <Fragment>.

Repară tu

Repară eroarea, direct în pagină

Componenta Card de mai jos pune className="card" pe un Fragment, iar React avertizează „Invalid prop className supplied to React.Fragment”. Repar-o ca titlul „Cană” și prețul „25 lei” să fie într-un element cu clasa card.

Codul care dă eroarea
JSX
import { Fragment } from "react";

function Card({ titlu, pret }) {
  return (
    <Fragment className="card">
      <h3>{titlu}</h3>
      <p>{pret} lei</p>
    </Fragment>
  );
}

export default function App() {
  return <Card titlu="Cană" pret={25} />;
}
Indiciu

Înlocuiește Fragment cu un div care primește className.

Alte forme ale mesajului

  • Warning: Invalid prop `style` supplied to `React.Fragment`. React.Fragment can only have `key` and `children` props.
  • Warning: Invalid prop `onClick` supplied to `React.Fragment`. React.Fragment can only have `key` and `children` props.

Cum o eviți pe viitor

  • Folosește Fragment doar când nu ai nevoie de stil, clasă sau evenimente pe grup.
  • Când înlocuiești un div cu <>, mută atributele lui pe un copil sau păstrează div-ul.
  • În liste, folosește <Fragment key={...}>, nu <>.
  • Urmărește avertismentele din consolă după refactorizări de JSX.

Întrebări frecvente

E mai rapid un Fragment decât un div?

Diferența e neglijabilă. Alegi Fragment ca să nu strici structura HTML (de exemplu în tabele sau liste), nu pentru viteză.

De ce nu dă eroare, doar avertisment?

Atributul e pur și simplu ignorat, deci aplicația merge mai departe. Dar stilul sau evenimentul pe care îl voiai nu există, așa că trebuie reparat.

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.