Design token
Ogni progetto conserva colori, tipografia e spaziature come design token e li serve dall'API. Un'app che li legge a runtime mostra un rebrand non appena i nuovi token sono pubblicati.
Un documento di token per progetto
I token sono un unico documento nel formato W3C Design Tokens. Ogni token è un valore con nome, come color.brand.primary. I tipi sono colori, famiglie di font, pesi dei font, dimensioni dei font, altezze di riga, spaziatura tra le lettere, tipografia composita, spaziatura, raggi degli angoli, ombre e bordi. Pulsanti, card, griglie di layout, breakpoint e movimento ne restano fuori.
Riferimenti tra token
Un token può fare riferimento a un altro tramite il suo percorso, quindi cambiare un valore aggiorna tutto ciò che punta a esso. I riferimenti vengono risolti sul server prima che i token siano serviti. Un documento con un ciclo di riferimenti, un riferimento sconosciuto, un tipo non corrispondente o un tipo non supportato viene rifiutato al salvataggio, e l'errore indica il percorso del token.
Bozza e pubblicato
Una modifica va in una bozza, che la faccia nella console, sotto designTokens nel tuo file di configurazione o tramite l'API. Il sito live continua a servire l'ultimo insieme pubblicato finché una release non pubblica la bozza. Per vedere l'anteprima dei token non pubblicati, una richiesta invia l'header del canale draft con una chiave che ha lo scope di lettura delle bozze.
Leggere i token nella tua app
La query GraphQL restituisce array piatti e risolti per ogni tipo di token, più source, il documento W3C grezzo per gli strumenti di build. Un'app che legge i token dall'API a runtime recepisce una modifica pubblicata senza un deploy. Un'app che li incorpora in fase di build deve comunque essere rigenerata.
Leggi il dettaglio
La guida ai design token copre i tipi di token, i modi per modificarli e come viene pubblicata la bozza.