التخطّي إلى المحتوى
menu palettetanreidark_modetranslate

وضع الألوان

التباين

نظام التصميم

أنظمة المعرض تحاكي أنظمة تصميم أخرى لتُظهر إلى أي مدى يمكن أن يصل Tanrei. إنها أمثلة، وليست تصاميم يدعمها Tanrei.

نسخ الرابطتعديل السمة
palettetanrei

وضع الألوان

التباين

نظام التصميم

أنظمة المعرض تحاكي أنظمة تصميم أخرى لتُظهر إلى أي مدى يمكن أن يصل Tanrei. إنها أمثلة، وليست تصاميم يدعمها Tanrei.

نسخ الرابطتعديل السمة
البدءWebReactSwiftUIJetpack ComposeFlutterReact Nativeالإعدادات الجاهزةنظام التصميم الخاص بكاستخدام Tanrei مع وكلاء الذكاء الاصطناعيالعلامة التجاريةرموز التصميمأنظمة التصميم والتخصيصTheme Studioاللونالطباعةالأيقوناتالشكلالارتفاعالحركةحالات التفاعلالسلوكالتخطيطالحجم والكثافةإمكانية الوصولالكلماترموز الألوانرموز السلّم الطباعيرموز الشكلرموز الارتفاعرموز الحركةرموز الحالةرموز التباعد والقياسالمكوّناتالزرزر الإجراء الرئيسيالزر المقسَّممتوفر في cupertino, m3-likeمجموعة الأزرارزر مع قائمةشريط الأدواتزر النسخخانة الاختيارزر الاختيارمفتاح التبديلالرقاقةقائمة الخياراتشريط التمريرحقل شريط التمريرالتقويمDateTimePickerمجموعة الحقولمجموعة أزرار الاختيارمجموعة خانات الاختيارعنصر الاختيارحقل الاختيارشريط القوائمرفع الملفاتمنتقي الملفات متقدّمساحة الإفلاتRatingحقل إدخال النص متقدّمحقل النصحقل الرقاقاتالحقلمربع التحرير والسرد متقدّمحقل التحرير والسردحقل إدخال العدد متقدّمحقل العددحقل إدخال اللون متقدّمحقل اللونحقل إدخال الرمز لمرة واحدة متقدّمحقل الرمز لمرة واحدةحقل إدخال النص المدمج متقدّممربع كتابة الرسائلالبطاقةالفاصلالطبقة النمطية متقدّممربع الحوارالقائمة (list)صف القائمةاللوحة السفليةاللوحة الجانبيةالعرض الدوّاركتلة الشيفرةالجدولاللوحة المنبثقةالخطواتالأكورديونقائمة الوصفالشكل التوضيحيهيكل التطبيقرأس الصفحةالعرض الشجريالخط الزمنيمعاينة الصورمقبض تغيير الحجمالإطار القابل لتغيير الحجمSplit viewمنطقة التمريرانتقال الحجمالشارةمؤشر التقدمالعدّادعارض الأرقام المتحرّكمؤشر التحميلشريط الإشعار (Snackbar)التلميحاختصار لوحة المفاتيحالوسمالشيفرة المضمَّنةالتنويهالصورة الرمزيةالحالة الفارغةمجموعة الوسومهيكل التحميلعنصر الملفمربع اللونالنص المتحركعلامات التبويبعرض التبويباتشريط التطبيقشريط التنقلدرج التنقلالبحثالرابطالتنقل بين الصفحاتروابط السابق والتاليمؤشر الخطواتمسار التنقلجدول المحتوياتبطاقة الرابطقائمة FABمتوفر في m3-likeالحالةكيف يُبنى Tanreiالمساهمةالترخيص والإسناد
الرئيسيةالأسسالحجم والكثافة

الحجم والكثافة

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

content_copyعرض بتنسيق Markdown

ارتفاع عنصر التحكم أو الصف تحدّده ثلاث قيم. ارتفاع عناصر التحكم والحد الأدنى للهدف يخصّان نظام التصميم كله: يضبط المنتج كلًّا منهما مرة واحدة، في طبقته. أما الحجم فيخصّ مكوّنًا واحدًا أو مجموعة منها: يكون الزر بالحجم small أو medium أو large حيث يوضع.

سلّم الأحجام

السلّم خمسة ارتفاعات، tanrei.sys.control.height.*، تقرؤها أحجام عناصر التحكم: الدرجة medium هي ارتفاع عناصر التحكم، tanrei.dial.control.height (و 40 افتراضيًّا)، والدرجات الأخرى أدنى منه وأعلى بعدد صحيح من وحدات الحجم (dial.size.unit، و 4px افتراضيًّا): small بوحدتين وextra-small بأربع تحته، وlarge بأربع وextra-large بثمانٍ فوقه. هذه هي الارتفاعات عند بضع قيم لارتفاع عناصر التحكم، محسوبة من قواعد رموز التصميم (design tokens) نفسها:

الرمز dial.control.height 36px dial.control.height 40px dial.control.height 44px dial.control.height 48px dial.control.height 56px
--tanrei-sys-control-height-extra-small 20px 24px 28px 32px 40px
--tanrei-sys-control-height-small 28px 32px 36px 40px 48px
--tanrei-sys-control-height-medium 36px 40px 44px 48px 56px
--tanrei-sys-control-height-large 52px 56px 60px 64px 72px
--tanrei-sys-control-height-extra-large 68px 72px 76px 80px 88px

مولَّد من design/tokens/tanrei.light.tokens.json, tokens/sys/measure.tokens.json

مكوّنات كثيرة تقرأ ارتفاعاتها من هذه الدرجات، والتي تقرأ درجة واحدة تبقى متساوية الارتفاع عند كل ارتفاع لعناصر التحكم: الأحجام small و medium و large في Button تقرأ الدرجات small و medium و large. وليس للسلّم نفسه حد أدنى، لأن extra-small لما لا يضغطه أحد، مثل الوسم أو اختصار لوحة المفاتيح.

الحد الأدنى للهدف

القيمة tanrei.sys.target.minimum هي أقل ارتفاع يُرسم به أي شيء يضغطه الشخص، وأقل عرض لعنصر تحكم ليس فيه إلا أيقونة. كل ارتفاع لصندوق أو صف يُضغط يُشتق منها حدًّا أدنى له، فلا حجم يرسمه أقل منها. إنها قيمة المطوّر: لا يغيّرها أي قرص ضبط، لأن الحد الأدنى الذي ينكمش مع ما يحدّه لا يبقى حدًّا أدنى.

في النظام الافتراضي، الحد الأدنى هو 36، للمؤشر وللإصبع على السواء. وارتفاعات Button تُظهر عمله: القيمة بين القوسين هي ما يعطيه الحجم وارتفاع عناصر التحكم، والارتفاع الذي قبلها هو ما يُبقي الحد الأدنى الزر عليه.

الرمز dial.control.height 36px dial.control.height 40px dial.control.height 44px dial.control.height 48px dial.control.height 56px
--tanrei-comp-button-container-height-small 36px (28px) 36px (32px) 36px 40px 48px
--tanrei-comp-button-container-height-medium 36px 40px 44px 48px 56px
--tanrei-comp-button-container-height-large 52px 56px 60px 64px 72px

مولَّد من design/tokens/tanrei.light.tokens.json, tokens/comp/button.tokens.json

وقيمتان أخريان تحدّدان من أي مساحة تُؤخذ الضغطة: sys.target.touch تحت الإصبع و sys.target.pointer تحت المؤشر الدقيق. كلتاهما تساوي الحد الأدنى افتراضيًّا، فقيمة واحدة تضبط الثلاث. والنظام الذي يتبع إرشادات منصة ما يرفعهما؛ وعندئذ يأخذ عنصر التحكم القائم وحده الضغطة من تلك المساحة الأكبر، أبعد مما يرسمه، ويُرسم الصف الملاصق لجيرانه بذلك الارتفاع. والعلامة التي تُرسم أصغر من الهدف، مثل مربع خانة الاختيار أو الرقاقة الصغيرة، تحتفظ بحجمها وتمدّ مساحة لمسها إلى الهدف. وهذا ما يضبطه كل نظام مضمَّن:

نظام التصميم minimum touch pointer
tanrei 36px 36px 36px
cupertino 28px 44px 28px
m3-like 32px 48px 44px

مولَّد من tokens/systems/*.system.json, design/tokens/<system>/tanrei.light.tokens.json

يتحقق البناء من كل نظام: ألا تقل أي من القيم الثلاث عن 24px (معيار WCAG 2.5.8)، وألا تقل touch و pointer عن الحد الأدنى أبدًا، وألا يتجاوز الحد الأدنى ارتفاع عناصر التحكم، وألا يقل أي ارتفاع له حد أدنى عن الحد الأدنى. وإذا ضبطت طبقة المنتج نفسه هدفًا أقل من 24px، أُبلغت بذلك تحذيرًا؛ أما مساحة ضغط أصغر من الحد الأدنى، أو حد أدنى أعلى من ارتفاع عناصر التحكم، فيُرفض في كل نظام.

ضبطها في طبقة

كلتاهما رمز تضبطه الطبقة مع ذكر السبب:

"tokens": {
  "tanrei.dial.control.height": { "$value": { "value": 32, "unit": "px" }, "reason": "A tool used all day with a mouse: controls and rows lower." },
  "tanrei.sys.target.minimum": { "$value": { "value": 32, "unit": "px" }, "reason": "Used with a mouse; 32 is the least we draw." }
}

على الويب، الارتفاعات تعابير CSS مبنية على أقراص الضبط، فضبط --tanrei-dial-control-height على العنصر الجذر يحرّك معًا كل الارتفاعات التي تتبعه، من دون بناء جديد. وفي أداة Theme Studio يضم صف «الحجم» ارتفاع عناصر التحكم ووحدة الحجم والحد الأدنى للهدف.

حجم يُضبط على حاوية

يُضبط الحجم حيث توضع المكوّنات. على الويب، الخاصية size لمجموعة الأزرار، متى ضُبطت، هي حجم كل Button فيها لا يضبط حجمًا خاصًّا به:

<tanrei-button-group size="small">
  <tanrei-button variant="outlined">Cancel</tanrei-button>
  <tanrei-button variant="filled">Publish</tanrei-button>
  <tanrei-button variant="text" size="medium">Details</tanrei-button>
</tanrei-button-group>
  • حجم المكوّن الخاص به هو الغالب. فالزر Button الثالث أعلاه بالحجم medium.
  • لا يُمرَّر إلا حجم مضبوط. المجموعة التي ليس لها size لا تمرّر شيئًا، فيُرسم كل Button فيها بحجمه الافتراضي medium، أو بالحجم الذي تضبطه حاوية تحيط بالمجموعة؛ وحين تتداخل الحاويات، تحسم الأمر أقربها مما يضبط حجمًا.
  • الحجم الذي لا يملكه المكوّن يصير أقرب حجم إليه على امتداد السلّم extra-small و small و medium و large و extra-large، والأكبر من حجمين متساويين في القرب.
  • لا ترسم مجموعة الأزرار ولا شريط الأدوات شيئًا خاصًّا بهما بحسب حجمهما. فمسافاتهما وزواياهما وفواصلهما تبقى كما يحدّدها طرازهما، حول عناصر بالارتفاع الذي تُرسم به.

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

ما يمرّر الحجم وما يأخذه

ثلاث حاويات تمرّر الحجم المضبوط عليها إلى ما تحمله:

وهذه المكوّنات تأخذ حجم أقرب تلك الحاويات إليها حين لا تضبط حجمًا خاصًّا بها، وتُرسم بالحجم medium حين لا تضبطه أي حاوية: الزر Button، والزر مع قائمة، وزر النسخ، وصف القائمة؛ ثم المكوّنات التي ترسم به كل صف أو جزء يخصّها: القائمة (list)، والعرض الشجري، والأكورديون، وجدول المحتويات، وقائمة الوصف، والجدول.

وعند هذا يقف الحجم. فالأكورديون وقائمة الوصف والجدول لا تمرّر حجمًا إلى ما تضعه فيها: الزر Button في خلية من الجدول يحتفظ بحجمه الخاص، أو يأخذ حجم الحاويات المحيطة بالجدول. وبعض المكوّنات لا تأخذ من أي حاوية حجمًا أصلًا:

  • قائمة الخيارات، ومنها قائمة السياق وقوائم شريط القوائم، وعرض البحث، وقائمة عنصر الاختيار أو مربع التحرير والسرد. فكلٌّ منها يُفتح فوق الصفحة، بمعزل عن عناصر التحكم المحيطة به، ولذلك لا يصغّر شريط أدوات بالحجم small قائمةَ الخيارات التي يفتحها زر Button فيه. وقائمة الخيارات والبحث بالحجم medium ما لم يضبط كلٌّ منهما size خاصًّا به؛ أما خيارات عنصر الاختيار أو مربع التحرير والسرد فتتبع حجم مربّعه.
  • عنصر الاختيار وحقل إدخال العدد وحقل إدخال النص وشريط التمرير داخل شريط الأدوات، فكلٌّ منها يحتفظ بالحجم الذي تعطيه إياه.
  • الخط الزمني، فحجمه هو حجم نصّه.