Guía práctica

Extractor de variables CSS — Guía de uso y principios técnicos

Extrae todas las propiedades personalizadas CSS (variables) del código CSS. Genera lista de variables y documentación.

Abrir herramienta

Resumen

La extracción de variables CSS es el proceso de identificar y listar todas las propiedades personalizadas CSS (--variable-name) del código CSS. Las variables CSS permiten temas dinámicos, mantenimiento más fácil y mejor organización del código. Las herramientas de extracción analizan código CSS para encontrar declaraciones de variables, extraen sus nombres y valores, y generan documentación. Esto es esencial para gestionar sistemas de diseño, mantener consistencia de temas y entender la arquitectura CSS. Las variables extraídas pueden exportarse para documentación, herramientas de gestión de temas o mantenimiento de sistemas de diseño.

Conceptos clave

Propiedades personalizadas CSS

Las propiedades personalizadas CSS (variables CSS) son entidades definidas por autores CSS que contienen valores específicos para reutilizar en todo un documento. Siguen la sintaxis --variable-name: value; y se acceden usando var(--variable-name). Las variables CSS permiten temas dinámicos, mantenimiento más fácil y mejor organización del código. Se propagan y heredan como propiedades CSS regulares, haciéndolas poderosas para crear sistemas de diseño y gestión de temas.

Extracción de variables

Extraer variables CSS implica analizar código CSS para encontrar todas las declaraciones --variable-name: value;. Las expresiones regulares pueden coincidir con el patrón --[\w-]+:\s*[^;]+; para identificar variables. Las herramientas de extracción proporcionan nombres de variables, valores y sus ubicaciones en el código. Esto es útil para documentación, gestión de temas y comprensión de la arquitectura CSS. Las variables extraídas pueden exportarse como JSON, CSV u otros formatos para procesamiento posterior.

Sistemas de diseño

Las variables CSS son fundamentales para los sistemas de diseño modernos. Permiten temas consistentes entre aplicaciones, esquemas de color dinámicos y ajustes de diseño responsivo. Los tokens de diseño (colores, espaciado, tipografía) a menudo se almacenan como variables CSS. Las herramientas de extracción ayudan a mantener sistemas de diseño proporcionando visibilidad de todas las variables definidas, sus valores y patrones de uso. Esto apoya la documentación y mantenimiento de sistemas de diseño.

Características

Detección automática

Detecta automáticamente todas las variables CSS (formato --variable-name) en el código CSS

Lista de variables

Genera lista completa con nombres de variables, valores y números de línea

Exportación JSON

Exporta variables como JSON para fácil integración con otras herramientas

Números de línea

Muestra números de línea donde se define cada variable para referencia fácil

Preguntas frecuentes

¿Qué propiedades personalizadas de CSS encuentra esta herramienta?

Busca en el código CSS declaraciones de propiedades personalizadas como --brand-color y --spacing-md, además de tokens de tema definidos en selectores, bloques :root, consultas de medios o ámbitos de componentes.

¿Puedo usarla para auditar tokens de diseño?

Sí. La lista extraída ayuda a revisar los nombres, los valores duplicados, la documentación que falta y el uso incoherente antes de incorporar las variables a un sistema de diseño.

¿La herramienta modifica mi CSS?

No. Solo analiza el CSS pegado y muestra las variables encontradas, sus valores y ubicaciones. La hoja de estilos original no se modifica.

Documentación relacionada

Extractor de variables CSS

Abre la herramienta para probar estas funciones.

Abrir herramienta