Tokens
¿Cómo cambias el tono, el espaciado o el contraste de cien pantallas sin buscar y reemplazar valores uno por uno?
La idea
Nombra la función de la decisión, no su valor bruto
En una tarjeta el texto, el borde y el botón usan hoy el mismo color #222222. ¿Qué pasa mañana cuando quieres que solo los botones cambien de color?
Ver la respuesta
Si las tres piezas apuntan directamente al valor bruto #222222, un «buscar y reemplazar» teñirá por accidente los párrafos y los bordes, o te obligará a revisar archivo por archivo para decidir cuál #222222 era botón y cuál era texto. Cuando cada pieza apunta a un token con nombre de función (--color-texto, --color-borde, --color-accion), aunque hoy valgan lo mismo, mañana puedes cambiar solo --color-accion con precisión quirúrgica.
Un valor dice cómo se ve algo; un token dice por qué se ve así y dónde más se repite.
Cuando empiezas una pieza pequeña, es tentador escribir los valores directos en cada bloque: color: #222222, padding: 16 px, background: #eeff41. Mientras haya una sola tarjeta, nada parece fallar. El problema aparece cuando el proyecto crece a treinta pantallas y el mismo #222222 se ha usado para los títulos, los bordes finos, el fondo de los botones y los iconos.
Un token de diseño introduce una capa de sentido entre el valor físico y las piezas que lo usan. En lugar de repartir #222222 por todas partes, guardas la decisión con un nombre que explica su papel: --tinta-principal, --borde-tarjeta o --fondo-accion. Hoy pueden apuntar al mismo negro, pero cada uno sabe qué trabajo cumple.
Míralo
Diecinueve grises al azar frente a un vocabulario compartido
En estas dos radiografías del código de un proyecto, ambas intentan construir tarjetas sobrias con texto jerarquizado, pero solo la segunda permite ajustar el contraste o el espaciado sin romper el conjunto.
No funciona: 19 grises al azar y 14 medidas sueltas
Funciona: 4 tokens de color y una escala de 5 espacios
En la primera versión no hubo mala intención: cada persona eligió un gris «parecido» (#666666, #6b6b6b, #707070, #737373) y un margen «más o menos medio» (13 px, 15 px, 21 px). Al cabo de unas semanas el sistema acumula decenas de valores huérfanos. En la segunda versión, cuatro tokens de color y cinco peldaños de espacio cubren las mismas necesidades sin ambigüedad.
Pruébalo
Dos capas de tokens conectadas a cuatro bloques en vivo
Consola de dos capas · tokens primitivos y tokens semánticos
A la izquierda ves el árbol de tokens (primitivos y semánticos); a la derecha, una mini interfaz con cabecera, tarjeta, campo de formulario y alerta que los consume en vivo. Reasigna el tema o cambia un token para ver cómo se propaga.
Guía de exploración
5 pasos
Cambia de tema sin tocar los componentes. En «Tema activo (reasignación semántica)», selecciona «Alto contraste».
La cabecera, la tarjeta, el formulario y la alerta cambiaron al unísono porque no tenían colores fijos: cada pieza lee tokens semánticos como «--superficie-papel» y «--tinta-principal».
Pista: Elige la segunda opción del primer control.
Prueba un registro editorial cálido. En «Tema activo (reasignación semántica)», selecciona «Editorial».
El mismo código de interfaz adopta una paleta de papel crema y acento terracota. El token separa qué función cumple cada elemento de qué valor concreto tiene hoy.
Pista: Elige la tercera opción del primer control.
Propaga el espacio interior desde un único punto. Sube «Token --espacio-interior» a 20 px o más.
El margen interno de la tarjeta, del bloque de formulario y del aviso crece de manera coordinada. Nadie tuvo que editar tres hojas de estilo por separado.
Pista: Arrastra el deslizador de espacio interior hacia la derecha.
Reasigna el token de acento semántico. En «Token --acento-estado apunta a», selecciona «Terracota (#b3261e)».
Cambiar a qué primitivo apunta el token semántico transforma al instante la etiqueta de estado y el indicador activo sin alterar textos ni bordes.
Pista: Elige la segunda opción del selector de acento.
Detecta un valor suelto («hardcoded») infiltrado. Abre «Más controles», activa «Infiltrar un valor bruto (#222222) sin token» y cambia «Tema activo (reasignación semántica)» a «Alto contraste».
Mientras toda la interfaz invierte sus colores con limpieza, el bloque que tenía «#222222» escrito a fuego queda negro sobre negro y se vuelve ilegible. Un solo valor sin token rompe la propagación del sistema.
Pista: Despliega «Más controles», marca la casilla y elige el tema «Alto contraste».
Guía completada. Combina temas, cambia el radio de borde o activa las etiquetas de tokens en «Más controles» para inspeccionar qué variable gobierna cada pieza.
Gobierna el margen interno de la tarjeta, del formulario y de la alerta desde un solo lugar.
Más controles
Propaga el redondeo a tarjetas, botones, entradas de texto e insignias.
Fija a fuego #222222 en el subtítulo del formulario para ver cómo falla al cambiar al tema de alto contraste.
Superpone las etiquetas de los tokens semánticos sobre la interfaz.
Configuraciones para probar
Fija el tema claro como A y cámbialo a Alto contraste o Editorial en B: verás que los cuatro componentes no cambian su estructura, solo el valor al que apuntan sus tokens semánticos.
Úsalo en tus composiciones
Tres reglas para diseñar una tabla de tokens que dure
Nombra el papel que cumple, no el color ni la coordenada
Si llamas a un token
–azul-oscuro, el día que la identidad pase a verde o actives un modo oscuro tendrás una variable llamada «azul» guardando un blanco o un verde. Nómbrala por su responsabilidad:–color-accion-primaria,–superficie-elevadao–borde-sutil.Empieza con pocos peldaños bien diferenciados
Cinco tokens de espacio (por ejemplo,
4 px,8 px,16 px,24 pxy40 px) resuelven casi cualquier interfaz. Si creas veinte peldaños separados por dos píxeles, el equipo volverá a dudar en cada tarjeta qué medida elegir.No dejes valores brutos sueltos dentro de los componentes
Un sistema de tokens es tan fiable como su pieza menos disciplinada. Si noventa y nueve elementos leen
var(–tinta-principal)pero uno solo tiene#222222escrito a mano, ese elemento quedará invisible la primera vez que cambies el tema de la superficie.
Tres errores frecuentes
Nombra el token por su función, no por su apariencia
El botón principal usa un token llamado «--azul-oscuro». Cuando la revista cambia su identidad a terracota o entra en modo oscuro, el nombre miente o obliga a buscarlo en todos los archivos. Cámbialo a un nombre semántico.
--azul-oscuro: #b3261e (contradicción semántica)
Consolida 12 medidas casi iguales en una escala de 5 tokens
Tres tarjetas contiguas tienen márgenes de 11 px, 15 px y 19 px nacidos al azar. Reduce la proliferación conectándolas a una escala de 5 tokens de espaciado.
12 medidas sueltas (7, 9, 11, 13, 15, 17, 19, 21 px…)
Caza el valor bruto infiltrado que rompe el cambio de tema
En modo de alto contraste, dos tarjetas se leen bien pero la tercera desaparece porque alguien escribió color: #222222 en vez de usar var(--tinta-principal). Sustituye el valor infiltrado por el token.
Tarjeta 3 con #222222 fijo sobre fondo oscuro.
Los tokens en piezas reales
Este mismo sitio (global.css): seis tokens gobiernan toda la cátedra
Publicación multitema: la misma noticia en edición día, noche y tinta electrónica
Escala modular de espaciado: cinco peldaños con propósito claro
Ponte a prueba
Distingue tokens semánticos, primitivos y valores infiltrados
Ponte a prueba
5 rondas
Cinco rondas sobre nomenclatura semántica, capas de tokens, valores infiltrados y escalas de espaciado.
Después de cada respuesta podrás consultar la explicación.
A fondo
Arquitectura en capas, estándar W3C y el peligro de la inflación
Por qué hacen falta dos capas: primitivos y semánticos
En 2016, mientras dirigía el sistema Lightning de Salesforce, Jina Anne acuñó el término design tokens para resolver un problema concreto: cómo mantener sincronizadas las decisiones visuales entre la web, las aplicaciones móviles y los archivos de diseño sin copiar códigos hexadecimales a mano. Poco después, Nathan Curtis y Alla Kholmatova (2017) sistematizaron por qué una sola lista de variables no basta y conviene separar dos capas:
- La capa primitiva (el qué existe): enumera las opciones físicas aprobadas en la paleta, como
--amarillo-400: #eeff41,--carbon-900: #222222o--escala-3: 16 px. Restringe el caos de millones de colores posibles a una docena de valores limpios, pero todavía no sabe dónde se usa cada uno. - La capa semántica (el para qué sirve): asigna intenciones de diseño a esos primitivos, como
--superficie-papel: var(--blanco),--tinta-principal: var(--carbon-900)o--acento-estado: var(--amarillo-400).
Cuando los componentes solo leen la capa semántica, cambiar del tema «Claro» al tema «Alto contraste» en el instrumento no requiere tocar ningún botón ni tarjeta: basta con reasignar a qué primitivo apunta cada token semántico.
Cuándo aparece una tercera capa: tokens de componente
En la mayoría de los proyectos editoriales y productos medianos, dos capas son suficientes. Sin embargo, en sistemas muy grandes o multimarca suele aparecer un tercer nivel: los tokens específicos de componente (por ejemplo, --boton-primario-fondo: var(--color-accion-primaria)).
Esta tercera capa solo se justifica cuando necesitas cambiar la apariencia de un componente concreto en una marca sin alterar los demás elementos que comparten el mismo rol semántico. Si no tienes esa necesidad real, añadir una tercera capa solo multiplica los nombres que el equipo debe memorizar.
El antecedente impreso y el estándar actual
Mucho antes de que existieran las variables CSS o el formato estándar del W3C Design Tokens Community Group (2024), el diseñador suizo Karl Gerstner propuso en Designing Programmes (1964) la misma operación mental: antes de dibujar una serie de carteles o páginas, definir una matriz de parámetros con nombre (proporciones, grosores de filete, familias tipográficas, gamas tonales) y hacer que cada pieza fuera una combinación regulada de esos parámetros.
Hoy ese principio se expresa como pares nombre-valor en archivos JSON o en propiedades personalizadas de CSS (--nombre-token), pero la ventaja intelectual sigue siendo idéntica: pensar el sistema como un conjunto de relaciones con significado en vez de una colección de medidas aisladas.
Quince tokens claros valen más que cuatrocientos olvidados
Crear un token para cada rincón destruye el propósito del sistema. Si un proyecto define --espacio-tarjeta-noticias-superior-movil, deja de tener reglas compartidas y vuelve a tener valores individuales disfrazados con nombres largos.
Un buen conjunto de tokens cabe en la cabeza de quien diseña. En este mismo sitio web, toda la arquitectura visual de los cursos y de la enciclopedia se sostiene sobre seis tokens de color (--amarillo, --tinta, --texto, --secundario, --papel, --regla) y dos tokens tipográficos (--serif y --sans). Cuando el vocabulario es corto y cada nombre tiene una razón evidente, nadie necesita inventar un decimonoveno gris.
Se relaciona con
- Sistemas y excepciones
Los tokens son el mecanismo concreto con el que un sistema codifica sus reglas compartidas para que todas las piezas las hereden sin repetirlas a mano.
- Roles semánticos
Un token semántico traduce un rol de comunicación (alerta, superficie, texto secundario) en una variable reutilizable que puede cambiar de valor según el tema.
- Componentes
Los componentes consumen tokens para definir sus colores, bordes y espacios interiores sin quedar atados a valores rígidos.
- Variantes
Muchas variantes de jerarquía o de estado se construyen reasignando qué tokens lee el componente en cada situación.
- Escalas tipográficas
Los peldaños de una escala tipográfica se guardan como tokens para que todos los titulares y cuerpos mantengan la misma proporción en cualquier pantalla.
Fuentes
- Jina Anne y W3C Design Tokens Community Group (2016). Design Tokens for Scaling Design Systems (Salesforce Lightning Design System) / Design Tokens Format Module.Definición original y especificación estándar de los tokens de diseño como pares nombre-valor independientes de la plataforma.
- Nathan Curtis y Alla Kholmatova (2017). Design Systems: A practical guide to creating design languages for digital products. Smashing Media.Arquitectura en capas de tokens: valores base (primitivos) frente a tokens semánticos (de propósito) y tokens de componente.
- Karl Gerstner (1964). Programme entwerfen / Designing Programmes. Arthur Niggli.El antecedente impreso directo de los tokens: definir parámetros con nombre en una matriz programática antes de dibujar las piezas.