مرجع SDK

التخطيط، الألوان والأزرار

نسخ الصفحة

التوسع والشاشة الكاملة، والتحريك والتأكيد على الإغلاق، ألوان رأس وخلفية Lia، وأزرار القائمة والعودة والإعدادات.

#الورقة والشاشة الكاملة

انظر ثلاثة مظهر لـ sheet, full و fullscreen.

#Lia.expand()

كورقة: تأخذ ارتفاع الشاشة بالكامل. يُعيد النتيجة بـ { expanded: true } (كما يحدث عندما كان بالفعل). تسمع الصفحة "viewport" الحدث مع الارتفاع الجديد.

#Lia.requestFullscreen()

من الطرف إلى الطرف، مع Lia فقط'أزرار الإغلاق العائمة و⋯ فوق صفحتك. تبدأ ورقة بالتوسع أولاً. تُرجع { isFullscreen: true }, وتفهم صفحتك "fullscreenChanged" مع الجديد contentSafeArea. حافظ على محتواك أقل من Lia.contentSafeArea.top.

#Lia.exitFullscreen()

العودة من الشاشة الكاملة: إلى ورقة إذا فتح التطبيق كورقة، وإلا إلى الشاشة الكاملة تحت Lia'عنوانه. يتم حلها مع { isFullscreen: false }.

#Lia.disableExpand()

كورقة: تبقى ارتفاعها، لذلك سحبها لأعلى لا يأخذ الشاشة بالكامل. Lia.expand() ما زال يمكنه. يُحل بـ null.

#Lia.enableExpand()

كورقة: سحبها لأعلى يأخذ الشاشة بالكامل مرة أخرى (الافتراضي).

#Lia.disableVerticalSwipes()

كورقة: لا يتم إغلاقها بالسحب لأسفل الآن. قم بإيقاف هذا الخيار للألعاب التي تستخدم السحب. يُعيد النتيجة بـ null.

#Lia.enableVerticalSwipes()

كورقة: يتم إغلاقها مرة أخرى بالسحب لأسفل (الافتراضي).

#الإغلاق

#Lia.enableClosingConfirmation()

يطلب التأكيد قبل الإغلاق، للعمل غير المحفوظ أو لعبة قيد التنفيذ: عندما يغلق الشخص تطبيقك باستخدام إغلاق أو من قائمة ⋯، يسأل Lia ما إذا كان يجب مغادرة التطبيق أولًا. يمكن أن تكون ورقة'ت يتم إغلاقها بالتمرير بينما هي'مفعلة. تُحلّ حلّاً بـ null.

Lia.enableClosingConfirmation(); // when a match starts
Lia.disableClosingConfirmation(); // when it ends

Lia.close() من صفحتك الخاصة تُغلق دون طلب.

#Lia.disableClosingConfirmation()

يغلق دون طلب مرة أخرى (الافتراضي).

#الألوان

#Lia.setBackgroundColor(color)

اللون خلف صفحتك، وخلف الأزرار السفلية. يتم حلها مع null.

معلمة	النوع
`color`	سلسلة	`#RRGGBB`, مثل `"#E9EEFF"`.

الأخطاء: bad_color.

#Lia.setHeaderColor(color)

لون Lia'العنوان فوق تطبيقك. تتحول نصوصها وأزرارها إلى فاتح أو داكن لتتناسب. تُرجع null. الأخطاء: bad_color.

Lia.setHeaderColor("#2F5BFF");

#الأزرار السفلية

#Lia.mainButton

زر واسع تحت صفحتك، باللون الأزرق في Lia ما عدا إذا قمّت بتلوينه، مثل تيليجرام'س MainButton. Lia.secondaryButton هو ثانٍ بجانبه أو فوقه، أبيض (أو Lia'لون البطاقة) مع نص أزرق. كلاهما مخفي حتى تظهرها.

Lia.mainButton.setParams({ text: "Buy for 5 LIA", is_visible: true });
Lia.mainButton.onClick(async function () {
  Lia.mainButton.showProgress();
  try { await buy("extra-lives"); } finally { Lia.mainButton.hideProgress(); }
});

كل طريقة تعيد الزر، لذلك يتم تسلسل المكالمات: Lia.mainButton.setText("Next").show().

الطريقة	ماذا يفعل
`Lia.mainButton.setText(text)`	اسمها، حتى 64 رمزاً. يُحدث `bad_text`.
`Lia.mainButton.setParams(params)`	عدة منها في وقت واحد (في الأسفل).
`Lia.mainButton.show()`	يظهره.
`Lia.mainButton.hide()`	يُخفيه.
`Lia.mainButton.enable()`	يسمح له بالضغط.
`Lia.mainButton.disable()`	يُظِلّها.
`Lia.mainButton.showProgress(leaveActive)`	مؤشر بدلًا من تسمية النص. إنه'معطلة أثناء الدوران، ما لم `leaveActive` هو `true`.
`Lia.mainButton.hideProgress()`	اسمها مرة أخرى، وتم تمكينها.
`Lia.mainButton.onClick(listener)`	يسمع نقرة.
`Lia.mainButton.offClick(listener)`	يوقف سماعه.

setParams تتلقى أيًا من هذه (تيليجرام'أسماء أو camelCase):

معلمة	النوع
`text`	سلسلة	حتى 64 حرفًا.
`color`	سلسلة أو فارغ	`#RRGGBB`, أو `null` لـ Lia's.
`text_color` أو `textColor`	سلسلة أو فارغ	`#RRGGBB`, أو `null` لـ Lia's.
`is_visible` أو `isVisible`	منطقية
`is_active` أو `isActive`	منطقية
`has_shine_effect` أو `hasShineEffect`	منطقية	مقبول، ولكن Lia لا'لم يتم رسم لمعان بعد.
`position`	سلسلة	للزرار الثانوي: حيث يجلس بجانب الرئيسي، `"left"` أو الافتراضي، `"right"`, `"top"` أو `"bottom"`.

يُثير bad_text, bad_color, bad_text_color أو bad_position لقيم لا'لإضاءتها على والانطفاء: أظهر واحدة حيث يمكن أن تبقى لفترة. لا تُحسب أي منهما ضمن الإعلانات الشاشة الكاملة

الزر'حالة، لقراءة:

الخصائص
`Lia.mainButton.type`	`"main"` أو `"secondary"`
`Lia.mainButton.text`	اسمها (`"Continue"` لزر الرئيسي و `"Cancel"` للزر الثانوي حتى تحدد واحدًا)
`Lia.mainButton.color`, `Lia.mainButton.textColor`	ألوانك، أو `null`
`Lia.mainButton.isVisible`, `Lia.mainButton.isActive`
`Lia.mainButton.isProgressVisible`	سواء كان مؤشر التحميل يظهر
`Lia.mainButton.hasShineEffect`
`Lia.mainButton.position`

#Lia.secondaryButton

الزر الثاني في الأسفل. نفس الطرق والخصائص كما Lia.mainButton; ضغطاته هي "secondaryButtonClicked" الحدث.

Lia.secondaryButton.setParams({ text: "Skip", is_visible: true, position: "left" }).onClick(skip);

#أزرار العنوان

#Lia.backButton

زر ظهور في بداية Lia'العنوان (في وضع الشاشة الكاملة، Lia'تتحول أزرار الإغلاق العائمة إلى زر العودة). استخدمها لشاشاتك الخاصة: أظهرها عندما ينتقل الشخص إلى شاشة واحدة، وارجع عندما يضغط عليها'تم الضغط. Lia لا'لمساعدتك في التنقل.

function openDetail(item) {
  showDetail(item);
  Lia.backButton.show();
}
Lia.backButton.onClick(function () {
  showList();
  Lia.backButton.hide();
});

طريقة أو خاصية
`Lia.backButton.show()`	يظهره. يعيد الزر.
`Lia.backButton.hide()`	يُخفيه.
`Lia.backButton.onClick(listener)`	يسمع نقرة (ال `"backButtonClicked"` الحدث).
`Lia.backButton.offClick(listener)`	يوقف سماعه.
`Lia.backButton.isVisible`	سواء كان'مُظهَر.

بينما يظهر زر العودة في وضع الشاشة الكاملة، يغلق الأشخاص تطبيقك من قائمة ⋯.

#Lia.settingsButton

يُضيف الإعدادات إلى تطبيقك'قائمة ... . الضغط عليها هو "settingsButtonClicked" الحدث. نفس الطرق كما Lia.backButton.

Lia.settingsButton.show().onClick(openSettings);

تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية