Extraer variables CSS: reúne todos los --var en una tabla

Contenido
Cuando un archivo CSS largo tiene propiedades personalizadas que empiezan por -- declaradas en varios sitios —:root, una clase concreta, una media query, etc.—, encontrarlas una por una a ojo resulta complicado.
En este artículo repasamos cómo funciona un extractor basado en expresiones regulares que reúne todas las declaraciones --variable en una sola tabla sin importar dónde estén declaradas, y cómo buscar por nombre o por valor en esa tabla para acotar la lista y copiar directamente en formato var(--nombre). También tratamos las reglas de coincidencia que tantas veces confunden, como cuando el valor aparece cortado a la mitad.
Resumen ① La expresión regular busca el patrón
--nombre: valoren todo el texto, sin distinguir entre:root, clases o media queries, y lo reúne en una tabla. ② Si escribes en el buscador parte de un nombre o de un valor, la lista se filtra en tiempo real. ③ Al pulsar el botón de copiar, se copia al portapapeles el formatovar(--nombre)en lugar del valor, así que puedes pegarlo directamente.
Por qué las variables CSS acaban repartidas por todas partes
Las propiedades personalizadas de CSS no se suelen declarar en un único lugar. Lo habitual es poner los valores por defecto en :root, las redefiniciones para el modo oscuro dentro de selectores como .dark o [data-theme="dark"], y los valores que solo cambian a cierto tamaño de pantalla aparte, dentro de una consulta @media.
Si a eso le sumas las variables locales que se declaran a nivel de componente, las declaraciones quedan repartidas de arriba abajo incluso dentro del mismo archivo.
En esa situación, para comprobar cuántas variables tiene ahora mismo el proyecto y si hay nombres duplicados, no queda otra que recorrer el archivo entero buscando línea a línea las que empiezan por --. Cuando el archivo pasa de varios cientos de líneas o está repartido en varios archivos CSS, es fácil que alguna variable se te escape.
Cómo buscarlas tú mismo sin herramientas
Como la sintaxis de las propiedades personalizadas de CSS está bien definida, puedes encontrarlas tú mismo con la misma regla incluso sin herramientas. El patrón clave es: detrás de --nombre viene dos puntos (:), después el valor, y este termina cuando aparece un punto y coma (;) o una llave de cierre (}).
Buscar en el editor de código y en la terminal
Si activas el modo de expresión regular en la función de búsqueda de tu editor de código y buscas --[a-zA-Z0-9-]+\s*:, se resaltarán todas las líneas del archivo que declaran una variable. En la terminal puedes extraer nombre y valor de una vez con el siguiente comando.
grep -oE -- '--[a-zA-Z0-9_-]+ *: *[^;{}]+' style.css
Este método no distingue si el selector es :root, .dark o está dentro de una media query: recorre todo el texto del archivo buscando únicamente el patrón --nombre: valor. Es el mismo principio que usa nuestra herramienta.
Comprobarlas en las herramientas de desarrollo del navegador
Si quieres ver los valores realmente aplicados en las herramientas de desarrollo del navegador, también puedes seleccionar el elemento :root en el panel Elements y buscar -- en la pestaña Computed. Eso sí, se trata del valor final calculado, así que no te dice en qué selector del código fuente se declaró.
Si tu CSS tiene decenas o cientos de líneas, es más rápido consultarlo todo en una tabla de una vez que repetir esta tarea a mano cada vez. Compruébalo con nuestra herramienta.
Encuentra todas las declaraciones --var del CSS que pegues, organízalas en una tabla y copia cada valor directamente en formato var(--nombre).

Reglas de coincidencia que suelen confundir
La expresión regular solo reconoce como declaración el patrón en el que los dos puntos vienen justo detrás de --nombre, y el valor se detiene en cuanto encuentra un punto y coma, una llave o un salto de línea. Por esta regla, hay situaciones en las que la variable no se detecta en absoluto o el valor sale cortado.
| Situación | Resultado | Motivo |
|---|---|---|
| El valor salta de línea antes del punto y coma | Solo se extrae hasta la primera línea | La expresión regular deja de buscar el valor en el salto de línea |
| El valor (una cadena, por ejemplo) contiene un punto y coma | Solo se extrae la parte anterior al punto y coma | Interpreta el punto y coma como el final del valor |
Texto --nombre: valor; dentro de un comentario | Se extrae tal cual | Recorre todo el texto sin distinguir si es un comentario |
El mismo nombre se declara en :root y en .dark, etc. | Cada uno aparece en una fila distinta | Coincide en orden, sin distinguir selectores |
Solo se referencia en el lugar del valor, como var(--nombre) | No se extrae | Para reconocerlo como declaración, los dos puntos deben venir detrás del nombre |
En especial, el punto y coma dentro de un valor de tipo cadena y las declaraciones dentro de comentarios son puntos con los que se tropieza a menudo. Si el resultado de la extracción no es el esperado, lo más rápido es comprobar primero en el CSS original si hay un punto y coma o un comentario alrededor de esa variable.
En resumen
- Las propiedades personalizadas de CSS se reconocen y se extraen únicamente por el patrón
--nombre: valor, sin importar si están declaradas en:root, en una clase o en una media query. - El valor se corta al encontrar un punto y coma, una llave o un salto de línea, así que si abarca varias líneas o contiene un punto y coma puede salir recortado.
- Las declaraciones dentro de comentarios también se reconocen como texto y se extraen tal cual, y si un mismo nombre se declara varias veces, todas aparecen en filas separadas.
- Si escribes en el buscador parte de un nombre o de un valor, la lista se filtra en tiempo real, y el botón de copiar copia el formato
var(--nombre), no el valor. - Aunque puedes buscarlas tú mismo con una expresión regular basada en el mismo principio, cuanto más largo es el archivo, más rápido resulta verlo todo en una tabla de una vez.
Encuentra todas las declaraciones --var del CSS que pegues, organízalas en una tabla y copia cada valor directamente en formato var(--nombre).
Preguntas frecuentes
¿También se extraen las variables que están fuera de :root?
Sí. La expresión regular no distingue selectores: busca únicamente el patrón --nombre: valor en todo el texto. Las variables declaradas dentro de un selector de clase o de una consulta @media aparecen en la tabla igual que las de :root.
¿Qué tengo que escribir en el buscador?
Basta con escribir parte del nombre de la variable o de su valor. No distingue mayúsculas de minúsculas y filtra en tiempo real los elementos que coinciden tanto en el nombre como en el valor.
Si pulso el botón de copiar, ¿se copia el valor tal cual?
No. Lo que se copia no es el valor original, sino una cadena con el formato var(--nombre). Está pensado para pegarla directamente dentro de otra regla CSS y hacer referencia a esa variable.
¿También se extraen las $variables de SCSS o las @variables de LESS?
No. El patrón que busca la expresión regular es solo el de las propiedades personalizadas nativas de CSS, que empiezan por --. Las variables de preprocesador que empiezan por $ o @ no entran en el resultado.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano