---
title: "الحجم والكثافة"
description: "سلّم من خمسة ارتفاعات لأحجام عناصر التحكم، وأصغر حجم يُرسم به كل ما يُضغط، وحجم تمرّره الحاوية إلى ما تحمله."
url: "https://tanrei.chnotchy.com/ar/foundations/size-and-density/"
last_updated: 2026-11-21T03:27:29.000Z
---

> هذه الصفحة جزء من توثيق Tanrei. يسرد الفهرس [llms.txt](https://tanrei.chnotchy.com/llms.txt) (بالإنجليزية) كل الصفحات، وتجتمع مواصفات مكوّنات النظام الافتراضي في ملف واحد هو [llms-full.txt](https://tanrei.chnotchy.com/llms-full.txt).

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

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

ارتفاع عنصر التحكم أو الصف تحدّده ثلاث قيم. **ارتفاع عناصر التحكم** و**الحد الأدنى للهدف** يخصّان نظام التصميم كله: يضبط المنتج كلًّا منهما مرة واحدة، في طبقته. أما **الحجم** فيخصّ مكوّنًا واحدًا أو مجموعة منها: يكون الزر بالحجم 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، أُبلغت بذلك تحذيرًا؛ أما مساحة ضغط أصغر من الحد الأدنى، أو حد أدنى أعلى من ارتفاع عناصر التحكم، فيُرفض في كل نظام.

## ضبطها في طبقة

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

```json
"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](https://tanrei.chnotchy.com/ar/foundations/theme-studio.md) يضم صف «الحجم» ارتفاع عناصر التحكم ووحدة الحجم والحد الأدنى للهدف.

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

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

```html
<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، والأكبر من حجمين متساويين في القرب.
- **لا ترسم مجموعة الأزرار ولا شريط الأدوات شيئًا خاصًّا بهما بحسب حجمهما.** فمسافاتهما وزواياهما وفواصلهما تبقى كما يحدّدها طرازهما، حول عناصر بالارتفاع الذي تُرسم به.

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

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

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

- [مجموعة الأزرار](https://tanrei.chnotchy.com/ar/components/button-group.md)، إلى أزرار Button فيها.
- [شريط الأدوات](https://tanrei.chnotchy.com/ar/components/toolbar.md)، إلى أزرار Button والأزرار مع قائمة فيه، داخل مجموعة كانت أو لا، وإلى زر الفائض.
- [القائمة (list)](https://tanrei.chnotchy.com/ar/components/list.md)، إلى صفوفها.

وهذه المكوّنات تأخذ حجم أقرب تلك الحاويات إليها حين لا تضبط حجمًا خاصًّا بها، وتُرسم بالحجم medium حين لا تضبطه أي حاوية: [الزر Button](https://tanrei.chnotchy.com/ar/components/button.md)، و[الزر مع قائمة](https://tanrei.chnotchy.com/ar/components/button-with-menu.md)، و[زر النسخ](https://tanrei.chnotchy.com/ar/components/copy-button.md)، و[صف القائمة](https://tanrei.chnotchy.com/ar/components/list-row.md)؛ ثم المكوّنات التي ترسم به كل صف أو جزء يخصّها: [القائمة (list)](https://tanrei.chnotchy.com/ar/components/list.md)، و[العرض الشجري](https://tanrei.chnotchy.com/ar/components/tree-view.md)، و[الأكورديون](https://tanrei.chnotchy.com/ar/components/accordion.md)، و[جدول المحتويات](https://tanrei.chnotchy.com/ar/components/table-of-contents.md)، و[قائمة الوصف](https://tanrei.chnotchy.com/ar/components/description-list.md)، و[الجدول](https://tanrei.chnotchy.com/ar/components/table.md).

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

- [قائمة الخيارات](https://tanrei.chnotchy.com/ar/components/menu.md)، ومنها قائمة السياق وقوائم [شريط القوائم](https://tanrei.chnotchy.com/ar/components/menubar.md)، وعرض [البحث](https://tanrei.chnotchy.com/ar/components/search.md)، وقائمة [عنصر الاختيار](https://tanrei.chnotchy.com/ar/components/select.md) أو [مربع التحرير والسرد](https://tanrei.chnotchy.com/ar/components/combobox.md). فكلٌّ منها يُفتح فوق الصفحة، بمعزل عن عناصر التحكم المحيطة به، ولذلك لا يصغّر شريط أدوات بالحجم small قائمةَ الخيارات التي يفتحها زر Button فيه. وقائمة الخيارات والبحث بالحجم medium ما لم يضبط كلٌّ منهما `size` خاصًّا به؛ أما خيارات عنصر الاختيار أو مربع التحرير والسرد فتتبع حجم مربّعه.
- عنصر الاختيار وحقل إدخال العدد وحقل إدخال النص وشريط التمرير داخل شريط الأدوات، فكلٌّ منها يحتفظ بالحجم الذي تعطيه إياه.
- [الخط الزمني](https://tanrei.chnotchy.com/ar/components/timeline.md)، فحجمه هو حجم نصّه.
