Variables y tokens · 12

Organizar y depurar las variables

Con 1.500 declaraciones, el problema ya no es usarlas sino encontrarlas y saber qué puede salir mal. Esta lección reúne los límites de var(), una convención de nombres para tu proyecto y una propuesta de estructura para tokens.css.

La idea nueva: var() solo se puede usar dentro del valor de una propiedad (o de otra variable). No sirve en selectores, nombres de propiedad, media queries ni para construir otros nombres. Cuando algo falla sin aviso, mira en DevTools → Computed: si la propiedad aparece como su valor inicial, la variable era inválida.
1 · circular → reserva coral
2 · --ba-var(--tono) → descartada, queda teal
3 · @media con var() → ignorado
4 · !important no viaja
5 · espacios en los extremos: no importan

Convención de nombres para el proyecto

--ba-* --fx-*
primitivos de marca y derivados (ya los tienes).
--st-*
estados: ok, warn, alert (ya los tienes).
--ink --panel --accent
semánticos que cambian con el tema (ya los tienes). Mejor con prefijo: --s-ink, --s-panel.
--r-* --e-* --t-*
escalas: radios (ya), espaciado y tamaños de texto (faltan).
--l-* --g-*
luz y gradientes (propuestos en las otras dos series).
--kpi-* --iso-*
API pública de cada componente; --_* para las privadas.
--v --i --h
datos que llegan del HTML. Cortos, sin prefijo, siempre números sin unidad.

Estructura propuesta para tokens.css

/* 1 · PRIMITIVOS — nunca se usan en componentes */
:root {
    --ba-blue: #005C84;  --ba-sky: #3C8CC0;  ...
    --fx-glow: #5FD4F5;  ...
    --st-ok: #2BB673;    --st-warn: #F2B33D;  --st-alert: #F97C75;
}

/* 2 · ESCALAS — no dependen del tema */
:root {
    --base: 4px;
    --e1: var(--base);  --e2: calc(var(--base) * 2);  ...   /* espaciado */
    --r-sm: 6px;  --r-md: 12px;  --r-lg: 18px;              /* radios    */
    --t-sm: 13px; --t-md: 15px;  --t-xl: 32px;              /* texto     */
    --ease: cubic-bezier(.19, 1, .22, 1);
}

/* 3 · SEMÁNTICOS — los cambia el tema */
:root, .theme-light {
    color-scheme: light;
    --ink: ...;  --panel: ...;  --accent: var(--ba-blue);
    --l-filo: ...;  --l-sombra: ...;     /* serie Luz       */
    --g-panel: ...; --g-datos: ...;      /* serie Gradientes */
}
@media (prefers-color-scheme: dark) { :root:not(.theme-light) { /* = .theme-dark */ } }
.theme-dark { color-scheme: dark; --ink: ...; --accent: var(--fx-cyan); ... }

/* 4 · REGISTRADAS — en un solo sitio */
@property --grow { syntax: '<number>'; inherits: true;  initial-value: 1; }
@property --p    { syntax: '<number>'; inherits: true;  initial-value: 0; }
@property --spin { syntax: '<angle>';  inherits: false; initial-value: 0deg; }

El CSS de las trampas



    

Ejercicios

  1. Mueve los cuatro @property de componentes.css a tokens.css y quita los que se repiten en las páginas de aprende.
  2. Haz que aprende.css use los tokens en lugar de sus colores hexadecimales escritos a mano.
  3. Abre una maqueta en DevTools, selecciona un .panel y busca en Computed de dónde viene su --accent.