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

PublicadoHerramientaExtractor de Variables CSS

Contenido
  1. Por qué las variables CSS acaban repartidas por todas partes
  2. Cómo buscarlas tú mismo sin herramientas
  3. Reglas de coincidencia que suelen confundir
  4. En resumen
  5. Preguntas frecuentes

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: valor en 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 formato var(--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.

Extractor de Variables CSS

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ónResultadoMotivo
El valor salta de línea antes del punto y comaSolo se extrae hasta la primera líneaLa expresión regular deja de buscar el valor en el salto de línea
El valor (una cadena, por ejemplo) contiene un punto y comaSolo se extrae la parte anterior al punto y comaInterpreta el punto y coma como el final del valor
Texto --nombre: valor; dentro de un comentarioSe extrae tal cualRecorre 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 distintaCoincide en orden, sin distinguir selectores
Solo se referencia en el lugar del valor, como var(--nombre)No se extraePara 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.
Extractor de Variables CSS

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

Artículos relacionados

  1. Cómo extraer enlaces de Markdown y verlos en una tablaAprende a extraer enlaces e imágenes de un Markdown: el patrón regex, los casos que se le escapan y cómo leer los resultados en tabla, lista de URL o JSON.
  2. Convertidor de enlaces URL: convierte direcciones en enlacesAsí se detectan las direcciones http y https de un texto y se convierten en etiquetas a, con target=_blank, rel=noopener noreferrer y texto acortado.
  3. Cómo comparar checksums y verificar la integridad de un archivoAprende a comparar el hash (checksum) MD5, SHA-1 y SHA-256 de un archivo descargado con el oficial y a detectar diferencias de un solo carácter.
  4. font-display swap: diferencias entre valores en una tablaCompara cómo los valores auto, block, swap, fallback y optional cambian los periodos block y swap, y qué significa el swap infinito (∞) en FOUT y FOIT.
  5. Cómo escribir @font-face en CSS: orden woff2, woff y ttfOrdena bien el src de @font-face: woff2, woff y ttf, con comillas en font-family y font-display: swap para evitar el texto invisible.
  6. Latitud y longitud de mi ubicación con su precisiónAprende cómo el navegador calcula tu latitud y longitud, qué significan accuracy, altitude y speed y por qué necesita HTTPS.

Herramientas relacionadas