Saltar al contenido
Cátedra / William Montoya Diseño visual

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

SIN TOKENS · VALOR BRUTO #222222#222222 → #b3261eTítulo en rojoPárrafo tambiénteñido por error.Botón acciónCON TOKENS · ROL SEMÁNTICO--color-texto--color-borde--color-accionTítulo intactoEl cuerpo y el bordeconservan su rol.Botón acción

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

VALORES SUELTOS EN EL CÓDIGO (19 GRISES)color: #666; · color: #6b6b6b; · border: #707070;color: #737373; · background: #fafafa; · #f4f4f4;Tarjeta A (pad: 13 px)Subtítulo en #6b6b6bBotón #292929Tarjeta B (pad: 21 px)Subtítulo en #737373Botón #11111114 medidas de margen sin relación: 7, 11, 13, 15, 19, 21 px…Cada pantalla parece diseñada por un equipo distinto.

Funciona: 4 tokens de color y una escala de 5 espacios

TOKENS DEL SISTEMA (4 COLORES · 5 ESPACIOS)--tinta: #222222 · --texto: #444444 · --secundario: #6f6f6f--espacio-xs: 4 px · -s: 8 px · -m: 16 px · -l: 24 px · -xl: 40 pxTarjeta A (--espacio-m)Usa --secundarioUsa --tintaTarjeta B (--espacio-m)Usa --secundarioUsa --tinta1 cambio en :root actualiza 100 pantallas sin buscar ni reemplazarLa decisión se toma una vez y se propaga con nombre propio.

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.

B · ahora
CAPA SEMÁNTICA (:root)--superficie-papel → #ffffff--tinta-principal → #222222--acento-estado → #eeff41--espacio-interior → 16 pxVista previa de los 4 bloquesAlerta gobernada por --acento-estado

Guía de exploración

5 pasos

  1. Cambia de tema sin tocar los componentes. En «Tema activo (reasignación semántica)», selecciona «Alto contraste».

  2. Prueba un registro editorial cálido. En «Tema activo (reasignación semántica)», selecciona «Editorial».

  3. Propaga el espacio interior desde un único punto. Sube «Token --espacio-interior» a 20 px o más.

  4. Reasigna el token de acento semántico. En «Token --acento-estado apunta a», selecciona «Terracota (#b3261e)».

  5. 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».

Tema activo (reasignación semántica)

Cambia a qué valores primitivos apuntan --superficie-papel y --tinta-principal sin tocar los componentes.

Token --acento-estado apunta a

Observa cómo cambian a la vez la insignia de estado, el foco del campo y el borde de la alerta.

16 px

Gobierna el margen interno de la tarjeta, del formulario y de la alerta desde un solo lugar.

Más controles
0 px

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

  1. 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-elevada o –borde-sutil.

  2. Empieza con pocos peldaños bien diferenciados

    Cinco tokens de espacio (por ejemplo, 4 px, 8 px, 16 px, 24 px y 40 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.

  3. 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 #222222 escrito 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)

Cómo nombras el token del botón principal

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…)

0 %

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.

Declaración de color en la tercera tarjeta

Los tokens en piezas reales

Este mismo sitio (global.css): seis tokens gobiernan toda la cátedra

SRC/STYLES/GLOBAL.CSS · :ROOT--amarillo--tinta--texto--secundario--papel--reglaPropagación de accesibilidad: #888888 → #6f6f6fCambiar una sola línea en :root subió el contraste de3,5:1 a 5,0:1 en todas las fechas, cotas y metadatos.--serif: 'PT Serif', Georgia, serif (lectura)--sans: 'Roboto', sans-serif (datos y controles)

Publicación multitema: la misma noticia en edición día, noche y tinta electrónica

UN SOLO COMPONENTE · TRES TABLAS DE TOKENS SEMÁNTICOSTEMA DÍACRÓNICAEl archivode tiposLectura sobrepapel claro concontraste suave.4 min · BogTEMA NOCHECRÓNICAEl archivode tiposTokens apuntana paleta oscuraverificada.4 min · BogTEMA E-INKCRÓNICAEl archivode tiposCero grises:todo en tinta100 % negra.4 min · Bog

Escala modular de espaciado: cinco peldaños con propósito claro

ESCALA DE TOKENS DE ESPACIO (PROGRESIÓN CON NOMBRE)--espacio-xs4 pxIcono ↔ etiqueta, superíndice--espacio-s8 pxEtiqueta ↔ campo de texto--espacio-m16 pxRelleno interior de tarjeta--espacio-l24 pxEntre tarjetas vecinas--espacio-xl40 pxSalto entre secciones

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: #222222 o --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.