Guida · Le fondamenta
Le variabili di tema
Un tema copre le variabili base, non le riscrive. Ma sui COLORI la copertura dev’essere totale: un ruolo omesso non degrada, sparisce.
Dove siamo
Hai cambiato una variabile e l’hai vista arrivare ovunque. Alla fine di questo capitolo saprai perché lo stesso sito, con un tema diverso, cambia colori senza che una pagina venga toccata — e cosa succede alle variabili che il tema non nomina.
Il gesto
Apri db.themes.json. È una lista. Ogni tema ha name, label — il nome leggibile, quello che compare in admin — e palette.
La palette ha quaranta chiavi: dieci ruoli, ognuno con la variante scura e con il proprio INCHIOSTRO — il colore leggibile che ci va sopra.
// db.themes.json — una voce della lista
{
"name": "uims",
"label": "UIMS (baseline)",
"palette": {
"primaryColor": "#262624",
"accentColor": "#66665F",
"dangerColor": "#B23D2E"
}
}Cos’è appena successo
Le variabili finali sono una sovrapposizione: base, poi palette, poi gli override del tema. L’ultima scrittura vince, e ciò che nessuno nomina resta il valore di base.
Per il MOVIMENTO, l’ombra e le superfici native questo vale ancora: un tema che tace prende il ripiego, e può essere corto. Per i COLORI no. Non c’è eredità: un ruolo omesso non degrada, sparisce — --color-<ruolo> resta indefinito e chi lo usa non dipinge niente.
È severo di proposito. Un tema è un insieme di INCARICHI, e un incarico vacante si deve vedere subito invece di somigliare a una scelta.
Un tema è più di una palette
Oltre ai colori un tema porta i font, e i font hanno un vincolo che i colori non hanno: devono essere caricati. Un nome che nessuno ha dichiarato fra quelli caricati non dà errore — dà il font di sistema.
La tipografia di un tema tuo la vediamo nel capitolo sull’estensione. Qui restiamo ai colori, che si sovrappongono e basta.
Quando non funziona
Scrivi una chiave che non esiste fra le variabili base — "primaryColour", all’inglese. Il tema si carica, l’admin lo elenca, e quel valore non tocca niente.
Nessuno verifica che le chiavi di una palette esistano. Se un tema «non cambia un colore», il primo sospetto è il nome della chiave, non la sovrapposizione.
Avanti
Adesso hai un fondo e dei temi che lo coprono. Manca un modo per dare un nome a un aspetto e riusarlo: gli stili.
Continua
Altro in «Le fondamenta»
Due modi di scrivere uno stileTutti i trentotto capitoliindice