@hanzo/ui

السمات

تُحل الرموز مقابل السمة، وتحمل الخصائص المخصصة الهوية، وثلاثة مقابض تدع الشخص يعيد ضبطها كلها.

لا شيء في المكتبة يسمّي لونًا. يطلب المكوّن $background أو $color12، فتجيب السمة، ويختلف الجواب بين الداكن والفاتح من غير أن يعلم المكوّن. تغيّر العلامة الجواب بوضع خاصية مخصصة؛ ويغيّره الشخص بتحريك مقبض تُضرب به التدرّجات.

الرموز

قيمة prop تبدأ بـ $ رمز. يجري تدرّج اللون من السطح إلى النص: $color1 أهدأ أرض، و$color12 أعلى النصوص صوتًا.

الرمزما هو
$backgroundأرض الصفحة. يقرأ --background، فتجيب عنه ورقة أنماط العلامة.
$colorلون النص الافتراضي.
$color1 – $color12التدرّج المحايد: $color2/$color3 أسطح مرفوعة، و$color10/$color11 نص خافت، و$color12 الأعلى صوتًا.
$borderColorالخط الشعري. شفّاف، فيُقرأ خطًا أفتح على أي سطح، لا رماديًا لا علاقة له.
$accentBackground / $accentColorعنصر التحكم الصاخب الوحيد المسموح به في الصفحة. يقرآن --primary، فيبلغهما مقبض التمييز.
defaultsecondarydestructiveoutline

السُلّم

المقاس والفراغ ونصف القطر الأرقام نفسها على كل مُضيف، وكل درجة تحمل مقبضًا.

الخط. fontSize="$n"، وليس رقمًا أبدًا. اثنتا عشرة درجة تقرأ تدرّج التصميم، من --text-xs إلى --text-9xl، والأربع بين الدرجات تستكمل جارتيها، فيحرّك مقياس الشخص الست عشرة وتبقى السُلّم سُلّمًا.

الدرجة$1$2$3$4$5$6$7$8$9$10$11$14
px111314151517212626324064

$1 لصيقة، و$2 تنقّل ومتن كثيف، و$3 الأساس، و$6 عنوان قسم، و$7 عنوان صفحة، و$8 فما فوق للعرض. درجات العرض تشدّ المسافة بين الأسطر وتتبّع الحروف إلى −0.025em، وهذا الفرق بين خط مُصفَّف وخط كبير فحسب.

الفراغ. تدرّج 4px، وهو وحده: $1 4 و$2 8 و$3 12 و$4 16 و$5 24 و$6 32 و$8 48 و$10 64. كل خطوة تُضرب في --density.

نصف القطر. أربع قيم. $1 و$2 هما 6، عنصر تحكم؛ و$3 و$4 هما 8، حقل أو صف؛ و$5 حتى $9 هي 12، لوحة؛ و$10 فما فوق الكبسولة. كل شيء عدا الكبسولة يُضرب في --radius-scale.

الخصائص المخصصة

الهوية مجموعة خصائص مخصصة على :root، الداكن أولًا، و.light يعيد ضبطها. يختم Hanzo على body الصنف .t_dark أو .t_light، ويجيب CSS عن الكتابتين، فتسمّي رموز المكوّنات وورقة الأنماط سمة واحدة.

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

المجموعة الكاملة هي --background و--foreground و--card و--popover و--primary و--secondary و--muted و--accent و--destructive، ولكل منها -foreground، ثم --border و--input و--ring و--radius، و--chart-1 حتى --chart-5، وعائلة --sidebar-*. تأتي من @hanzo/design وتُركَّب في الورقة التي يستوردها الجذر؛ والمُضيف الذي يركّب أيضًا ورقة design نفسها يتبعها مباشرة.

تعيد العلامة الضبط بإعلان الأسماء نفسها لاحقًا في التتالي. والمُضيف الذي يأتي بوجهه يربط --font-sans-provided لا --font-sans، لأن ربط الحزمة يقعد في طبقة، والإعلان خارج الطبقة يفوز مهما كانت خصوصيته.

مقابض المظهر

ينشر @hanzo/design ثلاثة مقابض يُضرب بها كل تدرّج، و@hanzo/appearance هو اللوح الذي يضعها لشخص:

المقبضما يحرّكه
--type-scaleكل درجة --text-*، ومعها كل fontSize="$n".
--type-ratioالمسافة بين الدرجات.
--densityكل خطوة --space-*، وكل فراغ وحشو في gui.
--primary / --accentاللون الصاخب الوحيد.
--font-sansوجه القراءة: وجه العلامة، أو النظام، أو ذو المذنّبات، أو الأحادي.
--container-max / --container-prose / --container-wideالمقاييس الثلاثة التي تُصفّ إليها الصفحة.

تنزل خصائص مضمّنة على html، وهو :root، فتفوز على كل ورقة أنماط بلا محدّد تُغلب خصوصيته، وتبلغ المكوّنات لأن gui يحل المقاس في JavaScript على أنه var(--text-base) والمتغيّر ما زال يقرأ التتالي عند العنصر. المحور الذي لم يضعه أحد غائب لا محايد: كتابة 1 تبدو مثلها وتعلو بصمت على علامة نشرت مقياسها.

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 تطبيق التفضيل المخزون عند كل تركيب، فيثبت الاختيار المصنوع في صفحة على التي تليها. عنصر التحكم في ترويسة هذا الموقع هو ذلك اللوح.