@hanzo/ui

Themes

Tokens lösen sich gegen das Theme auf, benutzerdefinierte Eigenschaften tragen die Identität, und drei Regler lassen eine Person das Ganze umstimmen.

Nichts in der Bibliothek nennt eine Farbe. Eine Komponente verlangt $background oder $color12, das Theme antwortet, und die Antwort unterscheidet sich zwischen dunkel und hell, ohne dass die Komponente es weiß. Eine Marke ändert die Antwort, indem sie eine benutzerdefinierte Eigenschaft setzt; eine Person ändert sie, indem sie einen Regler bewegt, mit dem sich die Rampen multiplizieren.

Tokens

Ein Prop-Wert, der mit $ beginnt, ist ein Token. Die Farbrampe läuft von der Fläche zum Text: $color1 ist der ruhigste Grund, $color12 der lauteste Text.

TokenWas es ist
$backgroundDer Grund der Seite. Liest --background, also antwortet das Stylesheet der Marke.
$colorDie Standard-Textfarbe.
$color1 – $color12Die neutrale Rampe: $color2/$color3 sind angehobene Flächen, $color10/$color11 gedämpfter Text, $color12 der lauteste.
$borderColorDer Haarstrich. Durchscheinend, also liest er sich auf jeder Fläche als hellere Linie und nicht als ein Grauton, der nicht dazugehört.
$accentBackground / $accentColorDas eine laute Steuerelement, das eine Seite haben darf. Lesen --primary, also erreicht sie der Akzent-Regler.
defaultsecondarydestructiveoutline

Die Leitern

Größe, Raum und Radius sind auf jedem Host dieselben Zahlen, und jede Sprosse trägt einen Regler.

Schrift. fontSize="$n", nie eine Zahl. Zwölf Sprossen lesen die Design-Rampe, von --text-xs bis --text-9xl, und die vier Sprossen dazwischen interpolieren ihre Nachbarn, sodass die Skala einer Person alle sechzehn verschiebt und die Leiter eine Leiter bleibt.

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

$1 ist eine Beschriftung, $2 Navigation und dichter Fließtext, $3 die Basis, $6 eine Abschnittsüberschrift, $7 ein Seitentitel, $8 und darüber Display. Display-Sprossen ziehen ihren Durchschuss und ihr Tracking auf −0.025em zusammen, und das ist der Unterschied zwischen gesetzter Schrift und Schrift, die bloß groß ist.

Raum. Die 4px-Rampe, und nur die: $1 4, $2 8, $3 12, $4 16, $5 24, $6 32, $8 48, $10 64. Jede Stufe wird mit --density multipliziert.

Radius. Vier Werte. $1 und $2 sind 6, ein Steuerelement; $3 und $4 sind 8, ein Feld oder eine Zeile; $5 bis $9 sind 12, eine Fläche; $10 und darüber sind die Pille. Alles außer der Pille wird mit --radius-scale multipliziert.

Benutzerdefinierte Eigenschaften

Die Identität ist ein Satz benutzerdefinierter Eigenschaften auf :root, dunkel zuerst, und .light stimmt sie um. Hanzo setzt .t_dark oder .t_light auf den Body, und das CSS antwortet auf beide Schreibweisen, sodass die Komponenten-Tokens und das Stylesheet ein Theme benennen.

: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;
}

Der volle Satz ist --background, --foreground, --card, --popover, --primary, --secondary, --muted, --accent, --destructive, jede mit ihrem -foreground, dann --border, --input, --ring, --radius, --chart-1 bis --chart-5, und die Familie --sidebar-*. Sie kommen aus @hanzo/design und werden in das Stylesheet komponiert, das die Wurzel importiert; ein Host, der auch das eigene Stylesheet von design einhängt, folgt ihm live.

Eine Marke stimmt um, indem sie dieselben Namen später in der Kaskade deklariert. Ein Host, der eine eigene Schrift mitbringt, bindet --font-sans-provided und nicht --font-sans, weil die Bindung des Pakets in einer Kaskadenebene sitzt und eine Deklaration ohne Ebene gewinnt, ganz gleich wie spezifisch sie ist.

Die Regler der Erscheinung

@hanzo/design veröffentlicht drei Regler, mit denen sich jede Rampe multipliziert, und @hanzo/appearance ist das Panel, das sie für eine Person setzt:

ReglerWas er bewegt
--type-scaleJede Sprosse --text-*, und mit ihr jedes fontSize="$n".
--type-ratioWie weit die Sprossen auseinanderliegen.
--densityJede Stufe --space-*, und jeder Gap und jedes Padding von gui.
--primary / --accentDie eine laute Farbe.
--font-sansDie Leseschrift: die der Marke, die des Systems, eine Serif, oder Mono.
--container-max / --container-prose / --container-wideDie drei Maße, auf die sich eine Seite setzt.

Sie landen als Inline-Eigenschaften auf html, und das ist :root, also gewinnen sie gegen jedes Stylesheet, ohne dass ein Selektor sie an Spezifität überbieten müsste, und sie erreichen die Komponenten, weil gui eine Größe in JavaScript als var(--text-base) auflöst und die Variable die Kaskade am Element weiter liest. Eine Achse, die niemand gesetzt hat, fehlt, statt neutral zu stehen: eine 1 zu schreiben sähe gleich aus und würde eine Marke, die ihre eigene Skala veröffentlicht hat, still überstimmen.

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 wendet die gespeicherte Vorliebe bei jedem Einhängen erneut an, also hält eine Wahl, die auf einer Seite getroffen wurde, auf der nächsten. Das Steuerelement in der Kopfzeile dieser Site ist dieses Panel.