خصائص واجهة SadUI والتخطيط
واجهة SadUI عربيّة RTL-أوّلًا: محتوى الشاشة يبدأ من اليمين. تُوصَف العناصر بخصائص عربيّة قانونيّة معرَّفة في مصدر الحقيقة.
المصدر:
language-truth/ui_props.yaml— 94 مفتاحًا. لكلّ مفتاح ثابت مولَّدsad::ui::props::<ID>يُقرأ في كود الرسوميّات (لا سلاسل خام).
المحاذاة المتقاطعة
خاصّيّة محاذاة تضبط المحاذاة المتقاطعة لأبناء العمود/الصفّ:
| الوضع | العمود (RTL) | الصفّ |
|---|---|---|
بداية (افتراضيّ) | يمينًا | أعلى |
وسط | توسيط | توسيط عموديّ |
نهاية | يسارًا | أسفل |
تمدّد | يملأ العرض | يملأ الارتفاع |
- «محاذاة» يُكرِّمها العمود والصفّ حصرًا (الشبكة/المكدّس/الالتفاف لها تموضع RTL مبيَّت خاصّ).
كلّ المفاتيح (94)
| المفتاح | الثابت props:: | النوع | لاتينيّ؟ | الوصف |
|---|---|---|---|---|
عنوان | TITLE | نص | نصّ العنوان الظاهر للزرّ والشريط والحوار والتبويب | |
محتوى | CONTENT | نص | محتوى النصّ لعنصر نص_عنصر ونظائره | |
نص | TEXT | نص | نصّ عامّ (اسم بديل شائع للمحتوى، ونصّ التلميح) | |
أيقونة | ICON | نص | رمز/أيقونة الزرّ العائم وزرّ الأيقونة (يقبل رمزًا نصّيًّا) | |
مصدر | SOURCE | نص | مصدر الصورة (مسار أو رابط) | |
اسم | NAME | نص | اسم الأيقونة المتجهة (مفتاح عنصر «أيقونة» — لا يخلط بمفتاح ICON) | |
تلميح | HINT | نص | نصّ التلميح الافتراضيّ لحقل الإدخال ومنطقة النصّ | |
قيمة | VALUE | عدد أو منطقيّ | القيمة الحاليّة (عدديّة للمنزلق/شريط التقدّم، منطقيّة للمفتاح/خانة الاختيار) | |
رسالة | MESSAGE | نص | نصّ الرسالة لشريط الإشعار | |
عرض | WIDTH | عدد | العرض الثابت (بالبكسل) لصندوق المقاس | |
ارتفاع | HEIGHT | عدد | الارتفاع الثابت (بالبكسل) لصندوق المقاس | |
محاذاة | ALIGN | نص | المحاذاة. للنصّ: «يمين»/«وسط» (أو right/center) — وإلّا يُحاذى النصّ العربيّ يمينًا تلقائيًّا. لحاويات العمود/الصفّ (المحور المتقاطع): «بداية» (افتراضيّ، اتّجاهيّ: العمود RTL يمينًا واللاتينيّ يسارًا، الصفّ أعلى) · «وسط» · «نهاية» (العمود يسار المحتوى في RTL، الصفّ أسفل) · «تمدّد» (يملأ المحور المتقاطع؛ يتخطّاه الابن ذو المقاس الصريح في ذلك المحور). | |
حشوة | PADDING | عدد | الحشو الداخليّ للحاوية (بالبكسل) — إزاحة الأبناء داخل حدود العنصر | |
حشوة_أعلى | PADDING_TOP | عدد | الحشو العلويّ للحاوية (بالبكسل) — منطقيّ عموديّ ثابت | |
حشوة_أسفل | PADDING_BOTTOM | عدد | الحشو السفليّ للحاوية (بالبكسل) — منطقيّ عموديّ ثابت | |
حشوة_بداية | PADDING_START | عدد | حشو جهة البداية (بالبكسل) — منطقيّ واعٍ بالـRTL (start=يمين) | |
حشوة_نهاية | PADDING_END | عدد | حشو جهة النهاية (بالبكسل) — منطقيّ واعٍ بالـRTL (end=يسار) | |
هامش | MARGIN | عدد | الهامش الخارجيّ (بالبكسل) — يُقحِم منطقة محتوى الحاوية | |
تباعد | SPACING | عدد | التباعد (بالبكسل) بين أبناء العمود/الصفّ المتتالين | |
وزن | WEIGHT | عدد | وزن المرونة (flex) — حصّة الابن من المساحة المتبقّية على المحور الرئيسيّ | |
أعمدة | COLUMNS | عدد | عدد أعمدة الشبكة (Grid) | |
حجم_خط | FONT_SIZE | عدد | حجم خطّ النصّ (بالبكسل) — يؤثّر على قياس النصّ عرضًا وارتفاعًا | |
حجم_الخط | FONT_SIZE_ALT | عدد | هجاء بديل لـ«حجم_خط» (بأل التعريف) — مقبول في القياس | |
حجم | SIZE | عدد | اسم مختصر لحجم الخطّ (بديل لـ«حجم_خط») | |
flex | FLEX_LATIN | عدد | ✔ | بديل لاتينيّ لـ«وزن» (flex) — يقرؤه التخطيط فقط |
columns | COLUMNS_LATIN | عدد | ✔ | بديل لاتينيّ لـ«أعمدة» — يقرؤه التخطيط فقط |
width | WIDTH_LATIN | عدد | ✔ | بديل لاتينيّ لـ«عرض» — يقرؤه التخطيط فقط |
height | HEIGHT_LATIN | عدد | ✔ | بديل لاتينيّ لـ«ارتفاع» — يقرؤه التخطيط فقط |
لون | COLOR | نص | اللون العامّ للعنصر (سلسلة سداسيّة #RRGGBB أو اسم لون) | |
لون_النص | TEXT_COLOR | نص | لون النصّ | |
لون_نص | TEXT_COLOR_ALT | نص | هجاء بديل لـ«لون_النص» (بلا أل) | |
خلفية | BG | نص | لون الخلفية (مفتاح مختصر) | |
لون_خلفية | BG_COLOR | نص | لون خلفية العنصر (المعدّل الرسميّ) | |
لون_نشط | ACTIVE_COLOR | نص | لون الحالة النشطة (مفتاح/زرّ مفعَّل) | |
حد_لون | BORDER_COLOR | نص | لون الحدّ الخارجيّ | |
زوايا | CORNER_RADIUS | عدد | نصف قطر تدوير الزوايا (بالبكسل) | |
نصف_قطر | RADIUS | عدد | نصف القطر (للدائرة/التدوير) | |
سماكة | THICKNESS | عدد | سماكة الخطّ/الحدّ (بالبكسل) | |
شفافية | OPACITY | عدد | الشفافية (0.0 شفّاف تمامًا … 1.0 معتِم) | |
ظل | SHADOW | نص | مواصفة الظلّ (وجوده/لونه) | |
تدرج | GRADIENT | نص | لون بداية التدرّج | |
تدرج_نهاية | GRADIENT_END | نص | لون نهاية التدرّج | |
رفع | ELEVATION | عدد | الارتفاع البصريّ (شدّة الظلّ) | |
مفعل | ENABLED | منطقيّ | هل العنصر مفعَّل (تفاعليّ) أم مُعطَّل | |
المجموع | TOTAL | عدد | القيمة القصوى (لشريط التقدّم/المنزلق) | |
الحالي | CURRENT | عدد | القيمة الحاليّة (لشريط التقدّم/المنزلق) | |
إزاحة_س | OFFSET_X | عدد | الإزاحة الأفقيّة بالبكسل — تمرير للحاويات القابلة للتمرير، وموضع حرّ لغيرها | |
إزاحة_ص | OFFSET_Y | عدد | الإزاحة الرأسيّة بالبكسل — تمرير للحاويات القابلة للتمرير، وموضع حرّ لغيرها | |
ايقونة | ICON_ALT | نص | هجاء بديل لـ«أيقونة» (بألف بلا همزة) — اسم الأيقونة | |
رمز | SYMBOL | نص | رمز نصّيّ (مثل محرف الأيقونة) | |
حرف | CHAR | نص | محرف واحد يُعرَض (نحو أوّل حرف من عنصر) | |
مسار | PATH | نص | مسار المورد (صورة ونحوها) | |
مجموعة | GROUP | نص | اسم مجموعة العنصر (أزرار الاختيار المترابطة ونحوها) | |
أدنى | MIN | عدد | القيمة الدنيا (منزلق/مدى) | |
أقصى | MAX | عدد | القيمة القصوى (منزلق/مدى) | |
إجمالي | TOTAL_SUM | عدد | المجموع الكلّيّ (بديل دلاليّ لـ«المجموع») | |
أرقام_أسطر | LINE_NUMBERS | منطقيّ | إظهار أرقام الأسطر (محرِّر الشيفرة) | |
حجم_خلية | CELL_SIZE | عدد | حجم الخليّة (بالبكسل) في الشبكة/الجدول | |
حدود | BOUNDS | نص | حدود المنطقة (نطاق/إطار) | |
دائرة | CIRCLE | منطقيّ | هل الشكل دائريّ (نحو صورة رمزيّة) | |
داكن | DARK | منطقيّ | هل السمة داكنة | |
سمك | THICKNESS_ALT | عدد | هجاء بديل لـ«سماكة» (سمك الخطّ/الحدّ) | |
صفحة | PAGE | عدد | رقم الصفحة (ترقيم الصفحات) | |
كود | CODE | نص | نصّ الشيفرة المصدريّة (كتلة/محرِّر شيفرة) | |
لغة | LANGUAGE | نص | لغة الشيفرة (للإبراز النحويّ) | |
لون_الايقونة | ICON_COLOR | نص | لون الأيقونة | |
لون_المقبض | HANDLE_COLOR | نص | لون مقبض المنزلق/المفتاح | |
محدد | SELECTED | منطقيّ | هل العنصر محدَّد (خانة اختيار/تبويب نشط) | |
نص_بديل | ALT_TEXT | نص | النصّ البديل (وصف الصورة للوصوليّة) | |
نوع | TYPE | نص | نوع العنصر (نوع حقل الإدخال ونحوه) | |
وصف | DESCRIPTION | نص | وصف نصّيّ للعنصر | |
content | CONTENT_LATIN | نص | ✔ | بديل لاتينيّ لـ«محتوى» |
title | TITLE_LATIN | نص | ✔ | بديل لاتينيّ لـ«عنوان» |
source | SOURCE_LATIN | نص | ✔ | بديل لاتينيّ لـ«مصدر» |
language | LANGUAGE_LATIN | نص | ✔ | بديل لاتينيّ لـ«لغة» |
alt | ALT_LATIN | نص | ✔ | بديل لاتينيّ لـ«نص_بديل» |
max | MAX_LATIN | عدد | ✔ | بديل لاتينيّ لـ«أقصى» |
min | MIN_LATIN | عدد | ✔ | بديل لاتينيّ لـ«أدنى» |
lat | LAT_LATIN | عدد | ✔ | خطّ العرض الجغرافيّ (خريطة) |
lng | LNG_LATIN | عدد | ✔ | خطّ الطول الجغرافيّ (خريطة) |
src | SRC_LATIN | نص | ✔ | بديل لاتينيّ لـ«مسار/مصدر» (مسار الصورة) |
value | VALUE_LATIN | عدد أو منطقيّ | ✔ | بديل لاتينيّ لـ«قيمة» |
placeholder | PLACEHOLDER_LATIN | نص | ✔ | بديل لاتينيّ لـ«تلميح» |
scroll_x | SCROLL_X_LATIN | عدد | ✔ | إزاحة تمرير أفقيّة (مفتاح لاتينيّ داخليّ للمُرسِّم) |
scroll_y | SCROLL_Y_LATIN | عدد | ✔ | إزاحة تمرير رأسيّة (مفتاح لاتينيّ داخليّ للمُرسِّم) |
مرونة | FLEX | عدد | نصيبُ العنصرِ من المساحةِ الفائضةِ في صفٍّ أو عمود (موسع/مرن) | |
نسبة | RATIO | عدد | نسبةُ العرضِ إلى الارتفاعِ لعنصرِ «نسبة_عرض» | |
عامل_العرض | WIDTH_FACTOR | عدد | كسرٌ من عرضِ الأبِ (٠–١) لعنصرِ «صندوق_نسبي» | |
عامل_الارتفاع | HEIGHT_FACTOR | عدد | كسرٌ من ارتفاعِ الأبِ (٠–١) لعنصرِ «صندوق_نسبي» | |
أدنى_عرض | MIN_WIDTH | عدد | الحدُّ الأدنى للعرضِ في عنصرِ «صندوق_مقيد» | |
أقصى_عرض | MAX_WIDTH | عدد | الحدُّ الأقصى للعرضِ في عنصرِ «صندوق_مقيد» | |
أدنى_ارتفاع | MIN_HEIGHT | عدد | الحدُّ الأدنى للارتفاعِ في عنصرِ «صندوق_مقيد» | |
أقصى_ارتفاع | MAX_HEIGHT | عدد | الحدُّ الأقصى للارتفاعِ في عنصرِ «صندوق_مقيد» | |
text | TEXT_LATIN | نص | ✔ | بديل احتياطيّ لاتينيّ (مسار UINode) — يقرؤه المُرسِّم فقط |
التفصيل المعماريّ (المحاور، الأوضاع، الهامش/الأوزان، الحرّاس) في مستودع اللغة:
docs/architecture/sadui-layout-alignment.md.