Token di design: panoramica
Il token di design sono gli elementi costitutivi di tutti gli elementi dell’interfaccia utente. Gli stessi token vengono usati nei file di design, negli strumenti e nel codice.
- I token puntano a valori di stile come colori, font e misure
- Usa il token di design al posto di valori hardcoded
- Ogni token è denominato in base a come o dove viene usato (ad esempio, md.comp.fab.primary.container.color imposta il colore del contenitore di una FAB)
- Anche se il valore finale di un token cambia, il suo nome e il suo utilizzo restano invariati
- Material Design prevede tre classi di token: token di riferimento, token di sistema e token di componente

Risorse
| Tipo | Collegamento | Stato |
|---|---|---|
| Design | Design Kit (Figma) | Disponibile |
| Material Theme Builder Figma plugin | Disponibile | |
| Implementazione | Tema baseline Material e relativi token (DSP) | Disponibile |
Che cos’è un token di design?
Il token di design sono piccole decisioni di design riutilizzabili che costituiscono lo stile visivo di un sistema di design. I token sostituiscono i valori statici con nomi autoesplicativi.
Un token di design è composto da due elementi:
- Un nome in formato codice, come md.ref.palette.secondary90
- Un valore associato, come #E8DEF8
Il valore del token può essere di diversi tipi: un colore, un carattere tipografico, una misura o persino un altro token.

Il token di design collegano in modo significativo scelte di stile che altrimenti non avrebbero una relazione evidente.
Ad esempio, se i mockup di un designer e l’implementazione di uno sviluppatore fanno entrambi riferimento allo stesso token per il “colore del contenitore secondario”, possono avere la certezza che lo stesso colore venga usato in entrambi i casi. Questo vale anche se il codice esadecimale assegnato a quel token viene aggiornato.

Perché i token sono importanti?
I token consentono a un sistema di design di disporre di un’unica fonte di verità: un repository in cui le scelte di stile vengono registrate e le modifiche possono essere monitorate.
Poiché i token sono riutilizzabili e orientati a uno scopo specifico, consentono di definire aggiornamenti a livello di sistema per temi e contesti. Ad esempio, puoi usare i token per applicare sistematicamente una tavolozza ad alto contrasto e migliorare la visibilità, oppure per modificare la scala tipografica e garantire la leggibilità del testo su uno schermo TV.
Usando i token sia nel design sia nell’implementazione, gli aggiornamenti di stile si propagano in modo coerente a tutto il prodotto o a una suite di prodotti. Inoltre, aiutano designer e sviluppatori a “parlare la stessa lingua”, riducendo la confusione nel passaggio dal design all’implementazione.

Stabilire se i token sono adatti alle tue esigenze
I token sono particolarmente utili se:
- Prevedi di aggiornare il design del tuo prodotto o stai creando un prodotto da zero
- Il tuo sistema di design si applica a una suite di prodotti o piattaforme
- Vuoi semplificare la manutenzione o l’aggiornamento degli stili in futuro
- Vuoi sfruttare al massimo il sistema Material Design, incluse funzionalità come il colore dinamico
I token sono meno utili se:
- Hai un’app esistente che usa valori hardcoded e che difficilmente verrà modificata nei prossimi uno o due anni
- Il tuo prodotto non dispone di un sistema di design
Token e Material Design
In passato, gli stili Material venivano comunicati tramite linee guida, file di design, strumenti e librerie di componenti specifiche per piattaforma.
Con il token di design, ora puoi scaricare, personalizzare e applicare gli stili Material e integrarli nel tuo processo di design e sviluppo.
I token consentono di documentare le decisioni in un formato indipendente dalla piattaforma e facilmente condivisibile.

In questo sito, i token sono elencati in moduli interattivi.
Questi moduli ti consentono di consultare rapidamente il valore baseline predefinito memorizzato dai token per colore, carattere, dimensione del carattere, peso del carattere e così via. Mostrano anche la relazione tra un ruolo, il relativo token di sistema, il token di riferimento e il valore preimpostato memorizzato.

I token sono presenti anche nelle schede Specifiche degli articoli dedicati ai componenti.
I token sono raggruppati prima per stato (abilitato, disabilitato, hover, ecc.) e poi per elemento, ovvero la parte del componente a cui si applica un token o un valore, come il contenitore o il testo dell’etichetta.
Le colonne includono:
- Nome – L’aspetto stilistico del componente a cui si applica il token, come colore o font
- ID token – Il token che definisce l’aspetto stilistico del componente
- Descrizione – Informazioni descrittive facoltative
- Contesto/valore – Il valore memorizzato nel token per un determinato contesto

Come usare i moduli dei token
Supponi di dover verificare il ruolo di colore del testo dell’etichetta di un pulsante filled.
Vai a Common buttons > Specs, individua il modulo token per i pulsanti filled e cerca i token del “testo dell’etichetta” sotto la voce elementi.
Copia il token del colore e incollalo nel codice, oppure confrontalo con il ruolo di colore in Figma.

Parti di un nome di token
Le parti di un nome di token sono separate da punti e vanno dall’informazione più generale (“md”) a quella più specifica (“on-secondary”).
- Tutti i nomi dei token in un sistema di design iniziano con il nome del sistema (ad esempio, “md” per Material Design)
- Segue un’abbreviazione per la classe di token: “ref” per i token di riferimento, “sys” per i token di sistema e “comp” per i token di componente
- Il nome termina con parole descrittive che ne indicano il ruolo

- Comunica il sistema di design
- Comunica la classe di token
- Comunica lo scopo del token
Classi di token
In Material esistono tre classi di token:
- Token di riferimento
Tutti i token disponibili con i relativi valori. - Token di sistema
Decisioni e ruoli che definiscono il carattere del sistema di design, dal colore e dalla tipografia all’elevazione e alla forma. - Token di componente
Le proprietà di design assegnate agli elementi di un componente, come il colore dell’icona di un pulsante.
Grazie alle tre classi di token, i team possono aggiornare le decisioni di design a livello globale o applicare una modifica a un singolo componente.

Token di riferimento
Questi token costituiscono tutte le opzioni di stile disponibili in un sistema di design.
Di solito puntano a un valore statico, come un codice esadecimale del colore o una dimensione del font, ma possono anche puntare ad altri token di riferimento. I token di riferimento non cambiano in base al contesto.
Fornendo un elenco di opzioni, i token di riferimento offrono al team un punto di partenza costituito da colori, tipografia, misure e altri valori approvati.
Tutti i token di riferimento iniziano con il prefisso ref.

Token di sistema
Questi token rappresentano le decisioni che strutturano il linguaggio di design per un tema o un contesto specifico.
I token di sistema definiscono il ruolo che un token di riferimento svolge nell’interfaccia utente.
È a questo livello che avviene la tematizzazione. Il token di sistema può puntare a token di riferimento diversi a seconda del contesto, ad esempio un tema chiaro o scuro.
Quando possibile, i token di sistema dovrebbero puntare a token di riferimento anziché a valori statici.
Tutti i token di sistema iniziano con il prefisso sys.

Token di componente (in sviluppo)
Questi token rappresentano gli elementi necessari per comporre un componente, come contenitori, testo dell’etichetta, icone e stati, insieme ai relativi valori di dimensione, forma, colore o elevazione.
Quando possibile, i token di componente dovrebbero puntare a un token di sistema o di riferimento, anziché contenere valori hardcoded come codici esadecimali.
Non tutte le scelte stilistiche di un componente possono essere espresse come token, ma ogni volta che una scelta di design si applica a più componenti con finalità simili, dovrebbe essere usato un token.
Tutti i token di componente iniziano con il prefisso comp.

Contesti
I token possono puntare a valori diversi in base a un insieme di condizioni. Tali condizioni sono chiamate contesti e i valori risultanti sono chiamati valori contestuali.
Esempi di contesti diversi includono fattori di forma dei dispositivi, tema scuro, layout densi e sistemi di scrittura da destra a sinistra.
Puoi considerare un contesto come una sorta di tag. Se un valore di token è contrassegnato con il tema scuro, sostituirà il valore predefinito del token in un contesto con tema scuro.
