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.
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.--s-ink, --s-panel.--_* para las privadas./* 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; }
@property de componentes.css a tokens.css y quita los que se repiten en las páginas de aprende.aprende.css use los tokens en lugar de sus colores hexadecimales escritos a mano..panel y busca en Computed de dónde viene su --accent.