Convertir SVG en componente React: qué cambia realmente

PublicadoHerramientaConvertidor de SVG a React JSX

Contenido
  1. Pegas el código, el icono aparece y la consola se llena de advertencias
  2. Cómo convertir a mano, sin herramientas
  3. Errores y confusiones habituales
  4. Resumen
  5. Preguntas frecuentes

Si pegas tal cual el código SVG que copiaste de una herramienta de diseño o de un sitio de iconos dentro de un componente de React o Next.js, el icono aparece en pantalla, pero la consola se llena de advertencias sobre atributos como stroke-width o class. No es que el código esté mal: pasa porque JSX lee los nombres de atributo con reglas distintas a las de HTML y XML (camelCase). En este artículo ordenamos esa diferencia en una tabla de reglas y explicamos qué cambia realmente el convertidor, solo con hechos comprobables.

Resumen ① JSX lee los nombres de atributo en camelCase, así que hay que cambiar class→className y stroke-width→strokeWidth para que las advertencias desaparezcan. ② El convertidor añade {...props} al final de la etiqueta de apertura <svg>, de modo que desde donde llames al componente puedas pasar className, fill, width y height para controlar el estilo. ③ Como el nombre del componente elimina todos los caracteres no alfanuméricos, hay que escribir un PascalCase en letras latinas como HeartIcon, no un nombre con espacios ni en otro alfabeto.

Pegas el código, el icono aparece y la consola se llena de advertencias

Imagina que copias un icono de Figma o descargas un SVG de un sitio de iconos y lo pegas tal cual dentro del return de un archivo .tsx. En pantalla el icono se ve perfecto. El problema está en la consola de las herramientas de desarrollo.

El modo de desarrollo de React muestra entonces advertencias más o menos así:

Warning: Invalid DOM property `stroke-width`. Did you mean `strokeWidth`?
Warning: Invalid DOM property `class`. Did you mean `className`?

Es decir, React te avisa de que «ese nombre de atributo no es el que se usa en JSX» y de paso te propone el nombre correcto en camelCase. En el caso de las clases CSS, en JSX lo estándar es usar className y no class, así que si dejas class="icon-heart" tal cual, además de la advertencia puede que el estilo no se aplique como esperas.

Estas advertencias se pueden corregir a mano una por una. El problema es que, si un icono tiene varios path y decenas de atributos, revisar a ojo cuáles hay que pasar a camelCase cada vez resulta pesado. La regla en sí es sencilla, así que empiezo por ahí.

Cómo convertir a mano, sin herramientas

Esta conversión se puede hacer entera a mano. El orden es este.

Paso 1 — envuélvelo en un componente. Envuelve el marcado SVG para que lo devuelva (return) un componente de función. El nombre de la función debe empezar obligatoriamente por mayúscula: JSX interpreta las etiquetas que empiezan por minúscula como elementos HTML y las que empiezan por mayúscula como componentes.

Paso 2 — pasa los atributos con guion a camelCase. Cambia la columna izquierda de la tabla de abajo por la de la derecha. Los nombres que React sugiere en la consola con «Did you mean …?» son exactamente esos.

Atributo SVG originalAtributo JSX (React)
classclassName
stroke-widthstrokeWidth
stroke-linecapstrokeLinecap
stroke-linejoinstrokeLinejoin
stroke-miterlimitstrokeMiterlimit
stroke-dasharraystrokeDasharray
stroke-dashoffsetstrokeDashoffset
stroke-opacitystrokeOpacity
fill-rulefillRule
fill-opacityfillOpacity
clip-ruleclipRule
stop-colorstopColor
stop-opacitystopOpacity
font-familyfontFamily
font-sizefontSize
font-weightfontWeight
xmlns:xlinkxmlnsXlink
xlink:hrefxlinkHref

Paso 3 — borra la declaración <?xml … ?> y los comentarios. La declaración XML del principio del archivo SVG y los comentarios <!-- … --> no se pueden usar tal cual en la sintaxis de JSX. Los comentarios de JSX tienen la forma {/* … */}, así que si dejas un comentario HTML se produce un error de sintaxis. Por eso es más seguro eliminarlos directamente.

Paso 4 — convierte la cadena de style en línea en un objeto. Una cadena como style="color:red" tiene que ser un objeto en React (style={{ color: "red" }}). Aquí no basta con cambiar el nombre: hay que cambiar la forma en sí.

Paso 5 — añade {...props} si lo necesitas. Si pones {...props} al final de la etiqueta de apertura <svg>, cuando uses este componente podrás pasarle valores como className, fill, width o height y controlar el estilo desde fuera.

La regla clave se resume en la única tabla del paso 2. Aun así, cuanto más complejo es el icono y más path tiene, más fácil es saltarse algo a mano, y cada vez toca volver atrás siguiendo las advertencias de la consola. Si lo pegas en el Convertidor de SVG a React JSX, puedes revisar todo el proceso de una vez.

Convertidor de SVG a React JSX

Con el Convertidor de SVG a React JSX conviertes un SVG en un componente React de TypeScript directamente en el navegador, sin crear cuenta. Lo que pegas no se envía a ningún servidor: se procesa al momento en la pantalla.

Errores y confusiones habituales

Pegarlo sin convertir. Es el caso más frecuente. Como hemos visto, atributos como stroke-width o class provocan advertencias en la consola, y desaparecen al pasarlos a camelCase. Este convertidor cambia de una vez los 18 atributos de la tabla de arriba.

Las reglas del nombre del componente. El convertidor borra del nombre todos los caracteres no alfanuméricos (espacios, guiones, guiones bajos, alfabetos como el coreano: todo se elimina). Y no convierte la primera letra en mayúscula. Por eso tienes que escribir tú mismo un PascalCase en letras latinas que empiece por mayúscula.

Nombre introducidoNombre que se genera
HeartIconHeartIcon
heart-iconhearticon
my_icon 2myicon2
«하트 아이콘» (icono de corazón)IconComponent

Si escribes solo caracteres no latinos y espacios, como en «하트 아이콘» (icono de corazón), no queda ninguna letra y el nombre se sustituye por IconComponent. Si empiezas por minúscula, como en heart-icon, el resultado es hearticon, solo sin el guion; ahora bien, un nombre que empieza por minúscula JSX lo trata como una etiqueta HTML y no como un componente, y eso da problemas al renderizar. Por eso hay que empezar por mayúscula, como en HeartIcon.

Dónde se coloca {...props}. El convertidor pone {...props} al final de la etiqueta <svg> de apertura. Es decir, primero van los atributos originales y después {...props}. En JSX, cuando se repite el mismo nombre, gana el valor que está detrás. Así que si pasas <HeartIcon fill="red" />, el valor que pasas sobrescribe el fill original. Al contrario, si no pasas nada, los atributos originales se quedan como valores por defecto.

Hay un detalle más. Si pasas className, no se fusiona con el className que viene del class original: lo sustituye por completo. Si quieres mantener la clase original y añadir otras, tienes que incluir también la clase original en el className que pasas.

La cadena de style en línea. Lo que cambia este convertidor son los nombres de atributo de la tabla de arriba, y nada más. Una cadena como style="…" se queda igual. React exige un objeto en style, no una cadena, así que si tu SVG lleva estilos en línea, esa parte tendrás que convertirla a objeto a mano.

Resumen

  • JSX lee los nombres de los atributos en camelCase. Si no cambias class→className o stroke-width→strokeWidth, aparecerá una advertencia en la consola.
  • La regla se resume en una sola tabla. El convertidor pasa esos 18 atributos con guion y de XML a camelCase de una vez.
  • Al final de la etiqueta de apertura <svg> se añade {...props}, así que desde donde uses el componente puedes pasar className, fill, width y height para controlar el estilo. Los valores que pases sobrescriben los del original.
  • Del nombre del componente solo se conservan letras y números; la mayúscula inicial la tienes que poner tú. Si solo pones caracteres coreanos o espacios, se sustituye por IconComponent.
  • La declaración <?xml?> y los comentarios no se pueden usar en JSX, por lo que se eliminan. Las cadenas de style en línea tienes que convertirlas aparte en un objeto.
Convertidor de SVG a React JSX

Con el Convertidor de SVG a React JSX conviertes un SVG en un componente React de TypeScript directamente en el navegador, sin crear cuenta. Lo que pegas no se envía a ningún servidor: se procesa al momento en la pantalla.

Preguntas frecuentes

¿Por qué aparece una advertencia si pego el SVG directamente en React?

Porque JSX lee los nombres de los atributos en camelCase (por ejemplo, strokeWidth) y no con guiones como HTML y XML. Cuando el modo de desarrollo de React encuentra un atributo como stroke-width, te sugiere el nombre correcto con un mensaje del tipo "Did you mean strokeWidth?". Basta con cambiar el nombre a camelCase para que la advertencia desaparezca.

¿Puedo poner caracteres coreanos o espacios en el nombre del componente?

Si los pones, esos caracteres se eliminan por completo. El convertidor solo deja letras y números en el nombre, así que si escribes algo como '하트 아이콘' (coreano y un espacio), no queda ningún carácter y se sustituye por IconComponent. Lo seguro es usar PascalCase en inglés y empezar con mayúscula, como HeartIcon.

¿Cómo cambio el color o el tamaño en el componente ya convertido?

El componente convertido lleva {...props} en la etiqueta de apertura <svg>, así que solo tienes que pasarle los valores cuando lo uses. Por ejemplo, con <HeartIcon fill="red" width={48} className="my-icon" /> esos valores sobrescriben los atributos originales. Pasa esto porque {...props} va al final de la etiqueta y los valores que pasas quedan después de los originales.

¿Puedo pegar un SVG que tenga comentarios o la declaración XML?

Sin problema. El convertidor borra automáticamente la declaración <?xml … ?> y los comentarios <!-- … -->. Ninguno de los dos puede quedarse tal cual en la sintaxis de JSX (los comentarios deben ir en la forma {/* … */}), así que dejarlos provocaría errores; por eso se eliminan durante la conversión.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. Texto a binario UTF-8: cómo se convierte cada letra en 0 y 1Cómo pasa un texto a ceros y unos con UTF-8: por qué el inglés ocupa 1 byte, el coreano 3 y los emojis 4, y cómo se recupera el texto.
  2. Comparar textos: cómo leer el diff en verde, rojo y grisCompara dos textos línea por línea: verde lo añadido, rojo lo eliminado y gris lo idéntico. Explicamos el LCS y por qué una letra cambia toda la línea.
  3. CSV coreano ilegible en Excel: cómo recuperar el textoPor qué el coreano de un CSV se ve como '뷁뷁' en Excel, qué son CP949, ANSI, UTF-8 y BOM, y cómo detectar la codificación y recuperar el texto.
  4. Quitar saltos de línea: unir el texto en una sola líneaPor qué aparecen saltos de línea al copiar de un PDF o una web y cómo unir todo en una línea cambiándolos por un espacio, sin palabras pegadas.
  5. Ajustar el número de caracteres de un texto: cómo se calculaDescubre dónde se rellena cada línea al alinear a la izquierda, derecha o ambos lados, cómo se cuentan los caracteres y qué pasa con las líneas más largas.
  6. Invertir texto al revés: letras, palabras, líneas y emojisCompara los tres modos de invertir un texto (letras, palabras y líneas), descubre por qué los emojis no se rompen y evita el error más común.

Herramientas relacionadas