Namespace tags are not supported by default. React's JSX doesn't support namespace tags. You can set `throwIfNamespace: false` to bypass this warning.
Ai în JSX un atribut sau un tag cu două puncte, de obicei într-un SVG copiat: xlink:href, xml:space, xmlns:xlink. În React aceste atribute se scriu în camelCase: xlinkHref, xmlSpace, xmlnsXlink (sau href simplu).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la pluginul React al lui Babel. Namespace tags sunt nume de forma prefix:nume, folosite în XML și în SVG-urile vechi: xlink:href, xml:space, xmlns:xlink, sodipodi:docname. JSX-ul nu le acceptă implicit, pentru că React nu are un mod de a le transmite așa.
Aproape mereu apare când lipești într-o componentă un SVG exportat din Figma, Illustrator sau Inkscape. Pentru atributele SVG cunoscute, React are nume în camelCase: xlinkHref, xmlSpace, xmlnsXlink. În SVG-ul modern, xlink:href se poate înlocui direct cu href.
Opțiunea throwIfNamespace: false din mesaj există, dar nu e soluția potrivită: atributele ar ajunge în pagină incorect. Mesajul nu arată mereu linia, deci caută în fișier caracterul : în interiorul tagurilor SVG.
De ce apare: cauzele frecvente
1xlink:href într-un <use> sau <image>
<svg>
<use xlink:href="#icon-cos" />
</svg><svg>
<use href="#icon-cos" />
</svg>href simplu funcționează în toate browserele moderne; dacă ai nevoie de forma veche, React o acceptă ca xlinkHref.
2Atribute xmlns:* și xml:* rămase din export
<svg xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve"><svg xmlnsXlink="http://www.w3.org/1999/xlink" xmlSpace="preserve">React cunoaște aceste atribute sub numele camelCase și le scrie corect în DOM. De obicei le poți și șterge.
3Metadate de editor în SVG
<svg sodipodi:docname="logo.svg" inkscape:version="1.3"><svg viewBox="0 0 24 24">Atributele editorului nu au niciun efect în pagină; șterge-le sau curăță SVG-ul cu un optimizator înainte să-l lipești.
Repară eroarea, direct în pagină
Componenta de mai jos afișează o iconiță SVG copiată dintr-un editor și nu compilează: dă eroarea „Namespace tags are not supported by default”. Repar-o ca elementul use să trimită la simbolul #icon-cos, iar sub iconiță să apară paragraful #eticheta cu textul „Coș”.
export default function App() {
return (
<div>
<svg width="0" height="0">
<symbol id="icon-cos" viewBox="0 0 24 24">
<path d="M3 4h18l-2 10H5z" />
</symbol>
</svg>
<svg width="24" height="24">
<use xlink:href="#icon-cos" />
</svg>
<p id="eticheta">Coș</p>
</div>
);
}Indiciu
În SVG-ul modern xlink:href se scrie simplu href.
Reparația
export default function App() {
return (
<div>
<svg width="0" height="0">
<symbol id="icon-cos" viewBox="0 0 24 24">
<path d="M3 4h18l-2 10H5z" />
</symbol>
</svg>
<svg width="24" height="24">
<use href="#icon-cos" />
</svg>
<p id="eticheta">Coș</p>
</div>
);
}De ce merge
JSX-ul transformă fiecare atribut într-o proprietate a unui obiect JavaScript, iar un nume ca xlink:href nu este acceptat de pluginul React al lui Babel, așa că fișierul nu compilează.
Atributul href face același lucru în SVG 2 și e înțeles de toate browserele actuale. Dacă ai nevoie de forma veche, React o acceptă ca xlinkHref și o scrie în DOM drept xlink:href.
Alte forme ale mesajului
SyntaxError: Namespace tags are not supported by default. React's JSX doesn't support namespace tags. You can set `throwIfNamespace: false` to bypass this warning. (3:9)Namespace tags are not supported. ReactJSX is not XML.
Cum o eviți pe viitor
- Înainte să lipești un SVG în JSX, trece-l printr-un optimizator (de exemplu SVGO) sau printr-un convertor SVG în JSX.
- Caută în SVG caracterul
:în numele atributelor și transformă-le în camelCase sau șterge-le. - Pentru iconițe folosite des, salvează SVG-ul ca fișier separat sau fă-l o componentă curată o singură dată.
Întrebări frecvente
Merită să setez throwIfNamespace: false?
Nu pentru un proiect React obișnuit: ar compila, dar atributele cu prefix nu ajung corect în DOM. Redenumește-le în camelCase sau folosește href.
De ce SVG-ul merge într-un fișier .html, dar nu în componentă?
Browserul citește SVG-ul ca XML și înțelege prefixele. JSX-ul este transformat în apeluri JavaScript, iar acolo xlink:href nu este un nume valid de proprietate.
Erori înrudite
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). Warning: Unsupported style property background-color. Did you mean backgroundColor? În obiectul style ai scris o proprietate CSS cu cratimă ("background-color"). React cere numele în camelCase: backgroundColor, fontSize, borderRadius. Warning: Invalid ARIA attribute `ariaLabel`. Did you mean `aria-label`? Atributele ARIA se scriu în JSX exact ca în HTML, cu cratimă și litere mici: aria-label, aria-hidden, aria-expanded. Spre deosebire de className sau onClick, ele nu se transformă în camelCase. Scrie aria-label="..." în loc de ariaLabel. Î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.
