@hanzo/ui

Temalar

Token’lar temaya göre çözülür, kimliği özel özellikler taşır ve üç ayar bir kişinin tamamını yeniden akort etmesini sağlar.

Kütüphanede hiçbir şey bir rengin adını koymaz. Bir bileşen $background veya $color12 ister, tema yanıtlar ve yanıt koyu ile açık arasında bileşenin haberi olmadan değişir. Bir marka yanıtı bir özel özellik koyarak değiştirir; bir kişi, ölçeklerin çarpıldığı bir ayarı oynatarak değiştirir.

Token’lar

$ ile başlayan bir prop değeri bir token’dır. Renk ölçeği yüzeyden metne gider: $color1 en sessiz zemindir, $color12 en gürültülü metin.

TokenNe olduğu
$backgroundSayfa zemini. --background okur, bu yüzden bir markanın stil sayfası ona yanıt verir.
$colorVarsayılan metin rengi.
$color1 – $color12Nötr ölçek: $color2/$color3 yükseltilmiş yüzeylerdir, $color10/$color11 kısık metin, $color12 en gürültülü.
$borderColorSaç teli. Yarı saydamdır, bu yüzden ilgisiz bir gri değil, herhangi bir yüzeyde daha açık bir çizgi olarak okunur.
$accentBackground / $accentColorBir sayfaya izin verilen tek gürültülü kontrol. --primary okurlar, bu yüzden vurgu ayarı onlara ulaşır.
defaultsecondarydestructiveoutline

Merdivenler

Boyut, aralık ve yarıçap her host’ta aynı sayılardır ve her basamak bir ayar taşır.

Yazı. fontSize="$n", asla bir sayı. On iki basamak tasarım ölçeğini okur, --text-xs ile --text-9xl arasında, ve basamakların arasındaki dördü komşularını ara değerler, bu yüzden bir kişinin ölçeği on altısını da oynatır ve merdiven merdiven kalır.

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

$1 bir etikettir, $2 gezinme ve sık gövde, $3 taban, $6 bir bölüm başlığı, $7 bir sayfa başlığı, $8 ve üzeri display. Display basamakları satır aralığını ve tracking’i −0.025em’e sıkar; dizilmiş yazı ile yalnızca büyük yazı arasındaki fark budur.

Aralık. 4px ölçeği ve yalnızca 4px ölçeği: $1 4, $2 8, $3 12, $4 16, $5 24, $6 32, $8 48, $10 64. Her adım --density ile çarpılır.

Yarıçap. Dört değer. $1 ve $2 6’dır, bir kontrol; $3 ve $4 8’dir, bir input veya bir satır; $5 ile $9 12’dir, bir panel; $10 ve üzeri hap. Hap dışında her şey --radius-scale ile çarpılır.

Özel özellikler

Kimlik, :root üzerindeki bir özel özellik kümesidir, önce koyu, .light onları yeniden akort eder. Hanzo body üzerine .t_dark veya .t_light basar ve CSS iki yazılışa da yanıt verir, bu yüzden bileşen token’ları ile stil sayfası tek bir tema adlandırır.

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

Tam küme --background, --foreground, --card, --popover, --primary, --secondary, --muted, --accent, --destructive, her birinin kendi -foreground değeri, sonra --border, --input, --ring, --radius, --chart-1 ile --chart-5 ve --sidebar-* ailesidir. @hanzo/design içinden gelirler ve kökün içe aktardığı stil sayfasına katılırlar; design’ın kendi sayfasını da monte eden bir host onu canlı izler.

Bir marka, aynı adları kaskatta daha sonra bildirerek yeniden akort eder. Kendi yüzünü getiren bir host --font-sans yerine --font-sans-provided bağlar, çünkü paketin bağlaması bir katmanda durur ve katmansız bir bildirim özgüllüğü ne olursa olsun kazanır.

Görünüm ayarları

@hanzo/design, her ölçeğin çarpıldığı üç ayar yayımlar ve @hanzo/appearance bunları bir kişi için kuran paneldir:

AyarNeyi oynatır
--type-scaleHer --text-* basamağını ve onunla birlikte her fontSize="$n" değerini.
--type-ratioBasamakların birbirinden ne kadar uzak durduğunu.
--densityHer --space-* adımını ve gui’deki her gap ile padding’i.
--primary / --accentTek gürültülü rengi.
--font-sansOkuma yüzü: markanınki, sisteminki, bir serif veya mono.
--container-max / --container-prose / --container-wideBir sayfanın yerleştiği üç ölçü.

html üzerine, yani :root üzerine, satır içi özellik olarak inerler, bu yüzden özgüllükte geçilecek bir seçici olmadan her stil sayfasını yenerler ve bileşenlere ulaşırlar, çünkü gui bir boyutu JavaScript’te var(--text-base) olarak çözer ve değişken öğedeki kaskadı hâlâ okur. Kimsenin kurmadığı bir eksen nötr değil, yoktur: 1 yazmak aynı görünür ve kendi ölçeğini yayımlamış bir markayı sessizce ezer.

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 saklanan tercihi her monte edilişte yeniden uygular, bu yüzden bir sayfada yapılan seçim sonrakinde durur. Bu sitenin başlığındaki kontrol o paneldir.