Tokens de diseño
Cada proyecto guarda sus colores, tipografía y espaciado como tokens de diseño y los sirve desde la API. Una app que los lee en tiempo de ejecución muestra un cambio de marca en cuanto se publican los nuevos tokens.
Un documento de tokens por proyecto
Los tokens son un único documento en el formato W3C Design Tokens. Cada token es un valor con nombre, como color.brand.primary. Los tipos son colores, familias tipográficas, grosores de fuente, tamaños de fuente, alturas de línea, espaciado entre letras, tipografía compuesta, espaciado, radios de esquina, sombras y bordes. Los botones, las tarjetas, las cuadrículas de diseño, los puntos de interrupción y el movimiento quedan fuera.
Referencias entre tokens
Un token puede referenciar a otro por su ruta, de modo que cambiar un valor actualiza todo lo que apunta a él. Las referencias se resuelven en el servidor antes de servir los tokens. Un documento con un ciclo de referencias, una referencia desconocida, un tipo que no coincide o un tipo no admitido se rechaza al guardarlo, y el error nombra la ruta del token.
Borrador y publicado
Una edición va a un borrador, ya la hagas en la consola, bajo designTokens en tu archivo de configuración o a través de la API. El sitio en vivo sigue sirviendo el último conjunto publicado hasta que una publicación publica el borrador. Para previsualizar tokens sin publicar, la solicitud envía el encabezado del canal de borrador con una clave que tenga el alcance de lectura de borradores.
Leer los tokens en tu app
La consulta de GraphQL devuelve arrays planos y resueltos para cada tipo de token, además de source, el documento W3C sin procesar para las herramientas de compilación. Una app que lee los tokens de la API en tiempo de ejecución recoge un cambio publicado sin necesidad de un despliegue. Una app que los incorpora en tiempo de compilación sigue necesitando recompilarse.
Lee el detalle
La guía de tokens de diseño cubre los tipos de token, las formas de editarlos y cómo se publica el borrador.