@hanzo/ui

Temi

I token si risolvono contro il tema, le proprietà personalizzate portano l'identità, e tre manopole lasciano che una persona ritocchi tutto.

Niente nella libreria nomina un colore. Un componente chiede $background o $color12, il tema risponde, e la risposta cambia tra scuro e chiaro senza che il componente lo sappia. Un marchio cambia la risposta impostando una proprietà personalizzata; una persona la cambia muovendo una manopola per cui si moltiplicano le rampe.

Token

Un valore di prop che inizia con $ è un token. La rampa dei colori va dalla superficie al testo: $color1 è il fondo più quieto, $color12 il testo più forte.

TokenChe cos’è
$backgroundIl fondo della pagina. Legge --background, quindi risponde il foglio del marchio.
$colorIl colore del testo per default.
$color1 – $color12La rampa neutra: $color2/$color3 sono superfici sollevate, $color10/$color11 testo attenuato, $color12 il più forte.
$borderColorIl filetto. Traslucido, quindi si legge come una linea più chiara su qualunque superficie, e non come un grigio che non c’entra.
$accentBackground / $accentColorL’unico controllo forte che una pagina può permettersi. Leggono --primary, quindi li raggiunge la manopola dell’accento.
defaultsecondarydestructiveoutline

Le scale

Dimensione, spazio e raggio sono gli stessi numeri su ogni host, e ogni gradino porta una manopola.

Carattere. fontSize="$n", mai un numero. Dodici gradini leggono la rampa di design, da --text-xs a --text-9xl, e i quattro gradini di mezzo interpolano i vicini, così la scala di una persona sposta tutti e sedici e la scala resta una scala.

Gradino$1$2$3$4$5$6$7$8$9$10$11$14
px111314151517212626324064

$1 è un’etichetta, $2 la navigazione e il corpo denso, $3 la base, $6 un titolo di sezione, $7 un titolo di pagina, $8 e oltre il display. I gradini di display stringono l’interlinea e il tracking a −0.025em, che è la differenza tra un carattere composto e un carattere che è soltanto grande.

Spazio. La rampa da 4px, e solo quella: $1 4, $2 8, $3 12, $4 16, $5 24, $6 32, $8 48, $10 64. Ogni passo si moltiplica per --density.

Raggio. Quattro valori. $1 e $2 sono 6, un controllo; $3 e $4 sono 8, un campo o una riga; da $5 a $9 sono 12, un pannello; $10 e oltre sono la pillola. Tutto, tranne la pillola, si moltiplica per --radius-scale.

Proprietà personalizzate

L’identità è un insieme di proprietà personalizzate su :root, prima lo scuro, e .light le ritocca. Hanzo mette .t_dark o .t_light sul body e il CSS risponde a entrambe le grafie, così i token dei componenti e il foglio di stile nominano un solo tema.

:root {
  --background: #0a0a0a;
  --foreground: #e5e5e5;
  --primary: #fafafa;
  --border: rgb(255 255 255 / .10);
  --ring: rgb(255 255 255 / .40);
  --font-sans: 'Zen', ui-sans-serif, system-ui, sans-serif;
  --font-mono: 'Zen Mono', ui-monospace, monospace;
}

L’insieme completo è --background, --foreground, --card, --popover, --primary, --secondary, --muted, --accent, --destructive, ognuno con il suo -foreground, poi --border, --input, --ring, --radius, da --chart-1 a --chart-5, e la famiglia --sidebar-*. Vengono da @hanzo/design e si compongono nel foglio che importa la radice; un host che monta anche il foglio proprio di design lo segue dal vivo.

Un marchio ritocca dichiarando gli stessi nomi più avanti nella cascata. Un host che porta un carattere proprio lega --font-sans-provided e non --font-sans, perché il legame del pacchetto vive in un livello e una dichiarazione senza livello vince, qualunque sia la sua specificità.

Le manopole dell’aspetto

@hanzo/design pubblica tre manopole per cui si moltiplica ogni rampa, e @hanzo/appearance è il pannello che le imposta per una persona:

ManopolaChe cosa muove
--type-scaleOgni gradino --text-*, e con esso ogni fontSize="$n".
--type-ratioQuanto distano i gradini.
--densityOgni passo --space-*, e ogni gap e padding di gui.
--primary / --accentL’unico colore forte.
--font-sansIl carattere di lettura: quello del marchio, quello del sistema, un serif, o mono.
--container-max / --container-prose / --container-wideLe tre misure su cui si compone una pagina.

Atterrano come proprietà in linea su html, che è :root, quindi vincono su qualunque foglio senza che un selettore debba superarle in specificità, e raggiungono i componenti perché gui risolve una dimensione in JavaScript come var(--text-base) e la variabile continua a leggere la cascata sull’elemento. Un asse che nessuno ha impostato è assente, non neutro: scrivere 1 avrebbe lo stesso aspetto e, in silenzio, supererebbe un marchio che ha pubblicato la propria scala.

import { Appearance } from '@hanzo/appearance'
import { bootScript } from '@hanzo/appearance/state'

// In <head>, so the first paint is already correct.
<script dangerouslySetInnerHTML={{ __html: bootScript() }} />

// Wherever the product keeps settings.
<Appearance />

Hanzo riapplica la preferenza salvata a ogni montaggio, quindi una scelta fatta su una pagina regge sulla successiva. Il controllo nell’intestazione di questo sito è quel pannello.