دلالات الأحجام

تثبت هذه الصفحة مفردات الأحجام المقصودة في خط alpha الحالي.

المصطلحات الأساسية

• الحجم المفضل: الحجم المطلوب عبر width وheight.
• الحجم الأدنى: الحد الأدنى الذي تفرضه min_width وmin_height.
• الحجم الأقصى: الحد الأعلى الذي تفرضه max_width وmax_height.
• الحجم الجوهري: الحجم المقاس من المحتوى قبل تعديلات التخطيط القادمة من الأب.

أنماط UVal

• Px: حجم ثابت بالوحدات المنطقية.
• Percent: نسبة من حجم الأب على ذلك المحور.
• Flex: يدخل في توزيع المساحة الحرة على المحور الرئيسي.
• MinContent: أصغر حجم جوهري ما زال يحتضن المحتوى.
• MaxContent: الحجم الجوهري الكامل من دون تمدد سياقي.
• Content: اسم عام قديم يبقى كمرادف عام لـ MaxContent.
• Auto: حجم سياقي. يعتمد على القياس الجوهري كحل احتياطي، لكن خوارزمية التخطيط قد تمدده أو تعيد تفسيره عندما يطلب سياق التخطيط ذلك.

القواعد الحالية

• قيود min_* وmax_* الصريحة تطبق دائمًا على الحجم النهائي، بما في ذلك إعادة توزيع flex grow وflex shrink.
• لم يعد Auto يعامل كنفس نمط Content.
• داخل grid يمكن لعناصر Auto أن تتمدد إلى الخلية افتراضيًا. أما MinContent وMaxContent فيحتفظان بالحجم الجوهري إلا إذا طلبت المحاذاة التمدد صراحة.
• في سلوك التمدد على المحور العرضي داخل flex يشارك Auto في التمدد الضمني. أما المحاذاة الصريحة فما تزال قادرة على فرض التمدد على الأنماط غير الثابتة وغير النسبية.
• يتعامل UImage مع Auto وContent وMinContent وMaxContent كأنماط قياس من الحجم الأصلي للصورة. ولأن للصورة حجمًا جوهريًا واحدًا فإن هذه الأنماط كلها تتحول إلى حجم الـ texture عندما تصبح الـ asset جاهزة.

إرشادات عملية

• استخدم Auto عندما تريد أن يتكيف الحجم مع سياق التخطيط.
• استخدم MaxContent أو Content عندما تريد أن يحتضن العنصر محتواه المقاس ويتجنب التمدد الضمني الخاص بـ Auto.
• استخدم MinContent عندما تريد أضيق احتواء جوهري ممكن.
• أضف min_width / max_width أو min_height / max_height عندما تحتاج حدودًا صريحة حول أي من الأنماط السابقة.