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.
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
<Fragment className="card">
<h3>{titlu}</h3>
</Fragment><div className="card">
<h3>{titlu}</h3>
</div>Ai nevoie de un element real ca să ai unde pune clasa.
2Eveniment pe Fragment
<Fragment onClick={deschide}>
<img src={poza} alt="" />
<p>{nume}</p>
</Fragment><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
{randuri.map((r) => (
<>
<dt>{r.cheie}</dt>
<dd>{r.valoare}</dd>
</>
))}{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ă 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.
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.
Reparația
function Card({ titlu, pret }) {
return (
<div className="card">
<h3>{titlu}</h3>
<p>{pret} lei</p>
</div>
);
}
export default function App() {
return <Card titlu="Cană" pret={25} />;
}De ce merge
Fragmentul nu apare în DOM, așa că className="card" nu avea pe ce să fie pus: React l-a ignorat, iar în pagină nu exista niciun .card.
Un div e un element real: primește clasa, iar titlul și prețul sunt acum în interiorul lui, unde le găsesc stilurile și selectorii.
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
divcu<>, 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
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>. Warning: Each child in a list should have a unique "key" prop. Elementele create cu map nu au prop-ul key, iar React nu le poate urmări între randări. Dă fiecărui element din listă o cheie stabilă și unică, de obicei id-ul din date: <li key={p.id}>. Warning: Invalid DOM property `class`. Did you mean `className`? În JSX atributul HTML class se scrie className, pentru că class este cuvânt rezervat în JavaScript. Înlocuiește class= cu className= (în tot fișierul). Î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.
