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

Namespace tags are not supported by default. React's JSX doesn't support namespace tags. You can set `throwIfNamespace: false` to bypass this warning.

Pe scurt

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>

Greșit
JSX
<svg>
  <use xlink:href="#icon-cos" />
</svg>
Corect
JSX
<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

Greșit
JSX
<svg xmlns:xlink="http://www.w3.org/1999/xlink" xml:space="preserve">
Corect
JSX
<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

Greșit
JSX
<svg sodipodi:docname="logo.svg" inkscape:version="1.3">
Corect
JSX
<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ă tu

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ș”.

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

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

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