Tokens de diseño: Descripción general
Los tokens de diseño son los componentes básicos de todos los elementos de la interfaz de usuario. Los mismos tokens se usan en diseños, herramientas y código.
- Los tokens hacen referencia a valores de estilo, como colores, tipografías y medidas.
- Usa tokens de diseño en lugar de valores codificados directamente.
- Cada token recibe un nombre que indica cómo o dónde se usa (por ejemplo, md.comp.fab.primary.container.color define el color del contenedor de un FAB).
- Aunque cambie el valor final de un token, su nombre y su uso no cambian.
- Material Design tiene tres clases de tokens: referencia, sistema y componente.

Recursos
| Tipo | Enlace | Estado |
|---|---|---|
| Diseño | Kit de diseño (Figma) | Disponible |
| Complemento Material Theme Builder para Figma | Disponible | |
| Implementación | Tema base de Material y sus tokens (DSP) | Disponible |
¿Qué es un token de diseño?
Los tokens de diseño son pequeñas decisiones de diseño reutilizables que conforman el estilo visual de un sistema de diseño. Los tokens reemplazan los valores estáticos por nombres autoexplicativos.
Un token de diseño consta de dos elementos:
- Un nombre con formato de código, como md.ref.palette.secondary90
- Un valor asociado, como #E8DEF8
El valor del token puede ser de varios tipos: un color, una tipografía, una medida o incluso otro token.

Los tokens de diseño vinculan de forma significativa decisiones de estilo que, de otro modo, no tendrían una relación clara.
Por ejemplo, si las maquetas de un diseñador y la implementación de un ingeniero hacen referencia al mismo token para el «color del contenedor secundario», pueden tener la certeza de que se usa el mismo color en ambos lugares. Esto se aplica incluso si se actualiza el valor hexadecimal asignado a ese token.

¿Por qué son importantes los tokens?
Los tokens permiten que un sistema de diseño tenga una fuente única de verdad: un repositorio donde se registran las decisiones de estilo y se pueden rastrear los cambios.
Como los tokens son reutilizables y tienen un propósito definido, permiten aplicar actualizaciones en todo el sistema para temas y contextos. Por ejemplo, puedes usar tokens para aplicar sistemáticamente una paleta de colores de alto contraste que mejore la visibilidad, o cambiar la escala tipográfica para garantizar que el texto sea legible en una pantalla de TV.
Al usar tokens para el diseño y la implementación, las actualizaciones de estilo se propagan de forma coherente en todo un producto o en un conjunto de productos. También ayudan a que los diseñadores e ingenieros «hablen el mismo idioma», lo que reduce la confusión durante el traspaso del diseño a la implementación.

Decidir si los tokens son adecuados en tu caso
Los tokens serán más útiles si:
- Planeas actualizar el diseño de tu producto o crear uno desde cero
- Tu sistema de diseño se aplica a varios productos o plataformas
- Quieres facilitar el mantenimiento y la actualización futura de los estilos
- Quieres aprovechar al máximo el sistema de Material Design, incluidas funciones como el color dinámico
Los tokens serán menos útiles si:
- Tienes una aplicación existente que usa valores codificados directamente y es poco probable que cambie durante el próximo año o los dos próximos
- Tu producto no tiene un sistema de diseño
Tokens y Material Design
En el pasado, los estilos de Material se comunicaban mediante guías, archivos de diseño, herramientas y bibliotecas de componentes específicas de cada plataforma.
Con los tokens de diseño, ahora puedes descargar, personalizar y aplicar estilos de Material, e integrarlos en tu proceso de diseño y desarrollo.
Los tokens permiten documentar las decisiones en un formato independiente de la plataforma y fácil de compartir.

En este sitio, verás los tokens en módulos interactivos.
Estos módulos te permiten consultar rápidamente el valor base (baseline) predeterminado que almacenan los tokens para color, tipografía, tamaño de fuente, peso de fuente, etc. También muestran la relación entre un rol, su token del sistema, su token de referencia y el valor predeterminado almacenado.

También verás tokens en las pestañas de especificaciones de las páginas de componentes.
Los tokens se agrupan primero por estado (habilitado, deshabilitado, al pasar el cursor [hover], etc.) y luego por elemento, que es la parte del componente a la que se aplica un token o valor, como el contenedor o el texto de etiqueta.
Las columnas incluyen:
- Nombre – El aspecto del estilo del componente al que se aplica el token, como el color o la tipografía
- ID del token – El token que define el aspecto del estilo del componente
- Descripción – Información descriptiva opcional
- Contexto/valor – El valor almacenado en el token para un contexto determinado

Cómo usar los módulos de tokens
Supongamos que necesitas verificar el rol de color del texto de etiqueta de un botón relleno.
Ve a Botones comunes > Especificaciones, encuentra el módulo de tokens de los botones rellenos y busca los tokens de «texto de etiqueta» en la sección de elementos.
Copia el token de color y pégalo en el código, o compáralo con el rol de color en Figma.

Partes de un nombre de token
Las partes de un nombre de token se separan por puntos y van desde la información más general («md») hasta la más específica («on-secondary»).
- Todos los nombres de tokens de un sistema de diseño empiezan con el nombre del sistema (por ejemplo, «md» para Material Design)
- Una abreviatura de la clase de token: «ref» para tokens de referencia, «sys» para tokens del sistema y «comp» para tokens de componentes
- El nombre termina con palabras descriptivas que indican la función del token

- Comunica el sistema de diseño
- Comunica la clase de token
- Comunica el propósito del token
Clases de tokens
Hay tres clases de tokens en Material:
- Tokens de referencia
Todos los tokens disponibles y sus valores asociados. - Tokens del sistema
Decisiones y roles que dan carácter al sistema de diseño, desde el color y la tipografía hasta la elevación y la forma. - Tokens de componentes
Las propiedades de diseño asignadas a los elementos de un componente, como el color del icono de un botón.
Con tres clases de tokens, los equipos pueden actualizar las decisiones de diseño de forma global o aplicar un cambio a un solo componente.

Tokens de referencia
Estos tokens conforman todas las opciones de estilo disponibles en un sistema de diseño.
Normalmente remiten a un valor estático, como un código de color hexadecimal o un tamaño de fuente, pero también pueden remitir a otros tokens de referencia. Los tokens de referencia no cambian según el contexto.
Al ofrecer una lista de opciones, los tokens de referencia proporcionan a tu equipo un punto de partida con colores, tipografía y medidas aprobados.
Todos los tokens de referencia empiezan con el prefijo ref.

Tokens del sistema
Son las decisiones que organizan de forma sistemática el lenguaje de diseño para un tema o contexto específico.
Los tokens del sistema definen el propósito que cumple un token de referencia en la interfaz de usuario.
Aquí es donde se aplica la tematización (theming). El token del sistema puede remitir a distintos tokens de referencia según el contexto, como un tema claro u oscuro.
Siempre que sea posible, los tokens del sistema deben remitir a tokens de referencia en lugar de valores estáticos.
Todos los tokens del sistema empiezan con el prefijo sys.

Tokens de componentes (en desarrollo)
Representan los elementos necesarios para componer un componente (como contenedores, texto de etiqueta, iconos y estados) y sus valores (como tamaño, forma, color o elevación).
Siempre que sea posible, los tokens de componentes deben remitir a un token del sistema o de referencia, en lugar de contener valores codificados directamente, como códigos hexadecimales.
No todas las decisiones de estilo de un componente pueden expresarse como un token; sin embargo, cuando una decisión de diseño se aplica a varios componentes con una finalidad similar, debe usarse un token.
Todos los tokens de componentes empiezan con el prefijo comp.

Contextos
Los tokens pueden remitir a distintos valores según un conjunto de condiciones. Estas condiciones se denominan contextos y sus valores resultantes se denominan valores contextuales.
Algunos ejemplos de contextos son: formatos de dispositivo, tema oscuro, diseños densos y sistemas de escritura de derecha a izquierda.
Puedes considerar un contexto como un tipo de etiqueta. Si el valor de un token tiene la etiqueta de tema oscuro, sustituirá el valor predeterminado del token en un contexto de tema oscuro.
