كل لون وكل مقاس يعيش تحت النوع GoHud داخل السمة، ويُطلب بالاسم.
والقاعدة ألّا تكتب أرقامًا: فالأسماء تتبع السمة حين تُبدَّل.
GoUi.color(GoTheme.ACCENT) # لون
GoUi.metric(GoTheme.GAP) # مقاس (dp)
GoUi.font_size(GoTheme.ROLE_CAPTION) # حجم دور نصّي
GoUi.box(GoTheme.BOX_CARD) # نسخة من StyleBoxالألوان
| الاسم | يُستعمل لـ |
|---|---|
background | أرضية الشاشة |
surface · surface_soft · surface_high | ثلاث طبقات لوحات — لوحة، بطاقة، خلية مرفوعة |
border | حدود البطاقات والأزرار |
text · secondary · muted | ثلاثة مستويات نص — متن، مساند، خافت |
accent · on_accent | لون التمييز والنص الموضوع فوقه |
success · warning · danger · info | ألوان الحالة نصًّا |
*_fill | الحالات نفسها تعبئةً — للأشرطة وسائر المساحات الكبيرة |
scrim · shadow · track | الحجاب خلف النوافذ المنبثقة، والظلال، ومجرى الشريط |
*_fill. المعنى واحد والمتطلبات متضادّة. فـ warning
المستعمل نصًّا يجب أن يكون داكنًا بما يكفي ليُقرأ على خلفية فاتحة؛ والمستعمل تعبئةً لشريط خبرة يجب أن
يكون ساطعًا بما يكفي ليُلحظ. ولا يستطيع توكن واحد أن يكون الاثنين — فشريط السمة الفاتحة صار بنيًّا.
والسمة التي تخلو من تنويعة _fill تعود إلى الاسم الأساسي تلقائيًا، فتبقى السمات الأقدم من
هذه التوكنات عاملة.
المقاسات (dp)
touch button_height gap_tiny gap_small
gap gap_large padding padding_compact
compact_padding_x compact_padding_y
radius_small radius radius_large screen_margin
scroll_deadzone scroll_edge scrollbar_width
list_glyph icon_size notice_duration_ms
عتامة اللوحة (%)
panel_alpha card_alpha hud_alpha notice_alpha
popup_alpha — إلى أي حدّ يكون وجه الحاوية معتمًا. 80 افتراضًا، فتبقى اللعبة
ظاهرة خلف مربع الحوار؛ وpopup_alpha هو 100. والسمة التي تخلو من هذه التوكنات تعود إلى 100
فترسم تمامًا كما كانت ترسم من قبل. واقرأ القيمة الناتجة نسبةً بـ
GoUi.surface_alpha(variant)؛ والقواعد في قسم
العتامة — اللعبة خلف اللوحة.
أدوار النص
micro · compact · caption · body ·
button · subtitle · title — الدور يسمّي حجمًا لا
غرضًا. "أكبر نص"، لا "العنوان". وبذلك يصمد السلّم حتى لو استعملته شاشة لشيء آخر.
تنويعات النوع
GoPanel GoCard GoButton GoPrimaryButton
GoDangerButton GoDangerSolidButton GoBareButton GoCompactButton
GoIconButton GoListButton GoTitleLabel GoSubtitleLabel
GoCaptionLabel GoCompactLabel GoMicroLabel