10 min CSS

Variables CSS

Imagina que tu cliente te dice "el naranja de la marca es demasiado chillón, cámbialo". Sin variables CSS, tienes que buscar y reemplazar #ff6b35 en 47 sitios y rezar para no romper nada. Con variables, lo cambias en un solo lugar. Son la base de cualquier sistema de diseño profesional.

Definir y usar variables

/* Definir variables en :root (disponibles en todo el documento) */
:root {
    --color-brand: #ff6b35;
    --color-bg: #0a0a0b;
    --color-surface: #141414;
    --color-text: #e0e0e0;
    --color-text-muted: #888;
    --color-border: #222;

    --font-sans: system-ui, -apple-system, sans-serif;
    --font-mono: ui-monospace, "Cascadia Code", monospace;

    --radius-sm: 4px;
    --radius-md: 8px;
    --radius-lg: 16px;

    --spacing-xs: 0.25rem;
    --spacing-sm: 0.5rem;
    --spacing-md: 1rem;
    --spacing-lg: 2rem;
    --spacing-xl: 4rem;
}

/* Usar variables con var() */
body {
    font-family: var(--font-sans);
    background: var(--color-bg);
    color: var(--color-text);
}

.card {
    background: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    padding: var(--spacing-lg);
}

Las variables CSS se llaman oficialmente custom properties. Siempre empiezan con -- y se acceden con var().

Valores de respaldo

.card {
    /* Si --color-surface no está definida, usa #141414 */
    background: var(--color-surface, #141414);

    /* Puedes encadenar fallbacks */
    color: var(--color-card-text, var(--color-text, #e0e0e0));
}

Herencia: las variables se heredan

A diferencia de la mayoría de propiedades CSS, las custom properties se heredan de padre a hijo. Esto las hace perfectas para crear contextos:

/* Variables globales */
:root {
    --accent: #ff6b35;
}

/* Redefinir para una sección específica */
.section-css {
    --accent: #1572B6;
}

.section-js {
    --accent: #f7df1e;
}

/* Los hijos usan la variable del contexto más cercano */
.section-title {
    color: var(--accent);       /* Naranja por defecto, azul en CSS, amarillo en JS */
}

.section-badge {
    background: color-mix(in oklch, var(--accent) 15%, transparent);
    color: var(--accent);
}

<section class="section-css">
    <h2 class="section-title">CSS</h2>  <!-- Azul -->
    <span class="section-badge">12 lecciones</span>  <!-- Badge azul -->
</section>

<section class="section-js">
    <h2 class="section-title">JavaScript</h2>  <!-- Amarillo -->
    <span class="section-badge">11 lecciones</span>  <!-- Badge amarillo -->
</section>

Mismo HTML, mismo CSS, diferentes colores. La variable se redefine en el contexto del padre y todos los hijos la heredan.

Variables y componentes

Las variables son perfectas para crear componentes configurables:

/* Componente botón con variables internas */
.btn {
    --btn-bg: var(--color-brand);
    --btn-text: #fff;
    --btn-padding-x: 1.5rem;
    --btn-padding-y: 0.75rem;
    --btn-radius: var(--radius-md);

    background: var(--btn-bg);
    color: var(--btn-text);
    padding: var(--btn-padding-y) var(--btn-padding-x);
    border-radius: var(--btn-radius);
    border: none;
    font-weight: 600;
    cursor: pointer;
    transition: background 0.2s;
}

.btn:hover {
    background: color-mix(in oklch, var(--btn-bg) 80%, black);
}

/* Variantes: solo cambian las variables */
.btn--secondary {
    --btn-bg: transparent;
    --btn-text: var(--color-brand);
    border: 2px solid var(--color-brand);
}

.btn--danger {
    --btn-bg: #ef4444;
}

.btn--sm {
    --btn-padding-x: 1rem;
    --btn-padding-y: 0.5rem;
    font-size: 0.875rem;
}

.btn--lg {
    --btn-padding-x: 2rem;
    --btn-padding-y: 1rem;
    font-size: 1.125rem;
}

<button class="btn">Comprar</button>
<button class="btn btn--secondary">Cancelar</button>
<button class="btn btn--danger btn--sm">Eliminar</button>

Un solo componente, múltiples variantes, cero duplicación de código.

Dark mode con variables

El patrón más limpio para implementar dark/light mode:

/* Tema claro (por defecto) */
:root {
    --color-bg: #ffffff;
    --color-surface: #f5f5f5;
    --color-text: #1a1a1a;
    --color-text-muted: #666;
    --color-border: #e0e0e0;
    --color-brand: #ff6b35;
}

/* Tema oscuro: respeta la preferencia del sistema */
@media (prefers-color-scheme: dark) {
    :root {
        --color-bg: #0a0a0b;
        --color-surface: #141414;
        --color-text: #e0e0e0;
        --color-text-muted: #888;
        --color-border: #222;
        --color-brand: #ff8c5a;  /* Versión más clara para contraste en dark */
    }
}

/* Todo el CSS usa las variables — se adapta automáticamente */
body {
    background: var(--color-bg);
    color: var(--color-text);
}

.card {
    background: var(--color-surface);
    border: 1px solid var(--color-border);
}

Cambiar de dark a light mode es cambiar un bloque de variables. El resto del CSS no se toca.

Toggle manual con clases

/* También puedes forzar el tema con una clase en <html> */
:root,
[data-theme="light"] {
    --color-bg: #ffffff;
    --color-text: #1a1a1a;
}

[data-theme="dark"] {
    --color-bg: #0a0a0b;
    --color-text: #e0e0e0;
}

<!-- El JS cambia el atributo data-theme -->
<html data-theme="dark">
    ...
</html>

Variables dinámicas con JavaScript

Las variables CSS son accesibles desde JavaScript, lo que permite interactividad avanzada:

.progress-bar {
    --progress: 0;
    width: calc(var(--progress) * 1%);
    height: 4px;
    background: var(--color-brand);
    transition: width 0.3s;
}

// Actualizar la variable desde JavaScript
const bar = document.querySelector(".progress-bar");
bar.style.setProperty("--progress", 75);  // 75% de ancho

Esto es mucho más limpio que manipular estilos inline directamente. El CSS controla la presentación, JavaScript solo cambia el dato.

Organización profesional de variables

:root {
    /* === Colores primitivos === */
    --gray-50: #fafafa;
    --gray-100: #f5f5f5;
    --gray-800: #1a1a1a;
    --gray-900: #0a0a0b;
    --orange-500: #ff6b35;
    --orange-600: #e55a2b;
    --green-500: #22c55e;
    --red-500: #ef4444;

    /* === Colores semánticos (referencian a los primitivos) === */
    --color-bg: var(--gray-900);
    --color-surface: var(--gray-800);
    --color-text: var(--gray-50);
    --color-brand: var(--orange-500);
    --color-brand-hover: var(--orange-600);
    --color-success: var(--green-500);
    --color-error: var(--red-500);

    /* === Tipografía === */
    --font-size-xs: 0.75rem;
    --font-size-sm: 0.875rem;
    --font-size-base: 1rem;
    --font-size-lg: 1.125rem;
    --font-size-xl: 1.25rem;
    --font-size-2xl: 1.5rem;
    --font-size-3xl: 2rem;

    /* === Espaciado === */
    --space-1: 0.25rem;
    --space-2: 0.5rem;
    --space-3: 0.75rem;
    --space-4: 1rem;
    --space-6: 1.5rem;
    --space-8: 2rem;

    /* === Sombras === */
    --shadow-sm: 0 1px 2px rgb(0 0 0 / 20%);
    --shadow-md: 0 4px 6px rgb(0 0 0 / 30%);
    --shadow-lg: 0 10px 15px rgb(0 0 0 / 40%);
}

Dos niveles: primitivos (los colores crudos) y semánticos (qué significan en tu diseño). Cambiar el tema es cambiar a qué primitivo apunta cada semántico.

Crea un mini sistema de diseño para Vinyl Paradise con variables CSS:

Define variables primitivas (colores raw) y semánticas (bg, surface, text, brand) en :root
Crea un tema dark (por defecto) y un tema light con @media (prefers-color-scheme: light)
Un componente .btn con variables internas y al menos 3 variantes (primary, secondary, danger)
Usa color-mix() para el hover de los botones
Crea secciones con diferentes colores de acento usando herencia de variables (como el ejemplo de secciones HTML/CSS/JS)
Una barra de progreso que use --progress como variable dinámica

Pistas

Empieza definiendo los colores primitivos, luego crea las variables semánticas que referencien a los primitivos. Para el toggle dark/light, asegúrate de que todo tu CSS use var(--color-...) y nunca colores hardcodeados.

Anterior Responsive design

Siguiente Animaciones y transiciones