السمات
تُحل الرموز مقابل السمة، وتحمل الخصائص المخصصة الهوية، وثلاثة مقابض تدع الشخص يعيد ضبطها كلها.
لا شيء في المكتبة يسمّي لونًا. يطلب المكوّن $background أو $color12، فتجيب السمة، ويختلف الجواب بين الداكن والفاتح من غير أن يعلم المكوّن. تغيّر العلامة الجواب بوضع خاصية مخصصة؛ ويغيّره الشخص بتحريك مقبض تُضرب به التدرّجات.
الرموز
قيمة prop تبدأ بـ $ رمز. يجري تدرّج اللون من السطح إلى النص: $color1 أهدأ أرض، و$color12 أعلى النصوص صوتًا.
| الرمز | ما هو |
|---|---|
$background | أرض الصفحة. يقرأ --background، فتجيب عنه ورقة أنماط العلامة. |
$color | لون النص الافتراضي. |
$color1 – $color12 | التدرّج المحايد: $color2/$color3 أسطح مرفوعة، و$color10/$color11 نص خافت، و$color12 الأعلى صوتًا. |
$borderColor | الخط الشعري. شفّاف، فيُقرأ خطًا أفتح على أي سطح، لا رماديًا لا علاقة له. |
$accentBackground / $accentColor | عنصر التحكم الصاخب الوحيد المسموح به في الصفحة. يقرآن --primary، فيبلغهما مقبض التمييز. |
السُلّم
المقاس والفراغ ونصف القطر الأرقام نفسها على كل مُضيف، وكل درجة تحمل مقبضًا.
الخط. fontSize="$n"، وليس رقمًا أبدًا. اثنتا عشرة درجة تقرأ تدرّج التصميم، من --text-xs إلى --text-9xl، والأربع بين الدرجات تستكمل جارتيها، فيحرّك مقياس الشخص الست عشرة وتبقى السُلّم سُلّمًا.
| الدرجة | $1 | $2 | $3 | $4 | $5 | $6 | $7 | $8 | $9 | $10 | $11 | $14 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| px | 11 | 13 | 14 | 15 | 15 | 17 | 21 | 26 | 26 | 32 | 40 | 64 |
$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 تطبيق التفضيل المخزون عند كل تركيب، فيثبت الاختيار المصنوع في صفحة على التي تليها. عنصر التحكم في ترويسة هذا الموقع هو ذلك اللوح.