SDK reference

Layout, kulay at mga button

Kopya ang pahina

Expanding at fullscreen, swipes at pagkumpirma ng pagbubukas, ang mga kulay ng header at background ni Lia, at ang mga button sa ibaba, pabalik at settings.

#Ang sheet at fullscreen

Tingnan Tatlong hitsura para sa sheet, full at fullscreen.

#Lia.expand()

Sa anyo ng isang sheet: kumakatawan sa buong taas ng screen. Nag-uwi sa { expanded: true } (din kung ang tao ay nagsara ng card). Nagbabalik ng isang function na humihinto sa pagpakinig. Ang pareho na "viewport" ang event na may bagong height.

#Lia.requestFullscreen()

Mula sa edge hanggang edge, na may lamang Lia'ang floating Close at ⋯ sa ibabaw ng iyong pahina. Ang isang sheet ay muna nagpapalawak. Nagreresolba sa { isFullscreen: true }, at ang iyong pahina ay nakikinig "fullscreenChanged" kasama ang bagong contentSafeArea. Panatilihin ang iyong nilalaman sa ilalim ng Lia.contentSafeArea.top.

#Lia.exitFullscreen()

Bumalik mula sa fullscreen: sa isang sheet kung ang iyong app ay buksan bilang isa, kung hindi man ay sa buong screen sa ilalim ng Lia'ng height ng header (isang sheet na inilabas, ang mga button sa ibaba ay ipinakita). { isFullscreen: false }.

#Lia.disableExpand()

Sa anyo ng isang sheet: panatilihin ang kaniyang taas, kaya ang pag-akyat nito ay hindi na kumakatawan sa buong screen. Lia.expand() nagawa pa rin. Nag-uugnay sa null.

#Lia.enableExpand()

Sa anyo ng isang sheet: pag-akyat nito ay kumakatawan muli sa buong screen (ang default).

#Lia.disableVerticalSwipes()

Sa anyo ng isang sheet: isang swipe pababa ay hindi na isara ito. I-off ito para sa mga laro na gumagamit ng swipes. Nag-uwi sa null.

#Lia.enableVerticalSwipes()

Sa anyo ng isang sheet: isang swipe pababa ay muli itong isara (ang default).

#Nag-uusap

#Lia.enableClosingConfirmation()

Nagtanong bago isara, para sa walang-sagot na trabaho o isang laro na nasa proseso: kapag ang tao ay isinara ang iyong app gamit ang Close o mula sa menu ng ⋯, Lia ay magtanong kung babalik muna. Ang isang sheet ay't isara habang ito'nasa. Nagsasagawa ng null.

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

Lia.close() mula sa iyong sariling pahina na nagsara nang walang pagtanong.

#Lia.disableClosingConfirmation()

Nag-uusap nang walang pagtanong muli (ang default).

#Mga kulay

#Lia.setBackgroundColor(color)

Ang kulay sa likod ng iyong pahina, at sa likod ng mga button sa ibaba. Nagreresolba sa null.

Parameter	Uri
`color`	string	`#RRGGBB`, pangalan `"#E9EEFF"`.

Mga error: bad_color.

#Lia.setHeaderColor(color)

Ang kulay ng Lia'ng header sa ibabaw ng iyong app. Ang teksto at mga button nito ay magbago sa madilim o liwanag para sumunod sa iyong kagustuhan. Nagreresolba sa null. Mga error: bad_color.

Lia.setHeaderColor("#2F5BFF");

#Mga pindutan sa ibaba

#Lia.mainButton

Isang malawak na button sa ilalim ng iyong pahina, sa Lia blue maliban kung ikaw ay naglilinis nito, tulad ng Telegram's MainButton. Lia.secondaryButton ay isang pangalawang isa sa tabi o nasa itaas nito, puti (o Lia'na kulay ng card) na may berde na teksto. Ang pareho ay naihide hanggang sa iyong ipakita sila.

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(); }
});

Bawat paraan ay bumabalik sa button, kaya ang mga pagtawag ay magkakasunod: Lia.mainButton.setText("Next").show().

Paraan	Ano ang ginagawa nito
`Lia.mainButton.setText(text)`	Ang kanyang label, hanggang 64 mga karakter. Nag-uulat `bad_text`.
`Lia.mainButton.setParams(params)`	Marami nang sabay (sa ibaba).
`Lia.mainButton.show()`	Nagpapakita nito.
`Lia.mainButton.hide()`	Iiwasan ito.
`Lia.mainButton.enable()`	Nagpapahintulot ito na ma-click.
`Lia.mainButton.disable()`	Nakakapula.
`Lia.mainButton.showProgress(leaveActive)`	Isang spinner sa halip na ang kanyang label. Ito'ang inaantok habang ito ay nagsisiklus, maliban kung `leaveActive` ay `true`.
`Lia.mainButton.hideProgress()`	Ang kanyang label muli, at nakabukas.
`Lia.mainButton.onClick(listener)`	Nakikinig sa isang pag-press.
`Lia.mainButton.offClick(listener)`	Nagtatapos ang pagbasa nito.

setParams kumukuha ng anumang mga ito (Telegram's mga pangalan o camelCase):

Param	Uri
`text`	string	Hanggang sa 64 mga karakter.
`color`	string o null	`#RRGGBB`, o isang ref o getter ( `null` para sa Lia's.
`text_color` o `textColor`	string o null	`#RRGGBB`, o isang ref o getter ( `null` para sa Lia's.
`is_visible` o `isVisible`	boolean
`is_active` o `isActive`	boolean
`has_shine_effect` o `hasShineEffect`	boolean	Tanggap, ngunit Lia ay hindi'hindi mag-iiwan ng shine.
`position`	string	Para sa pangalawang pindutan: kung saan ito nakatayo kasama ang pangunahing isa, `"left"` (ang default), `"right"`, `"top"` o `"bottom"`.

Nag-uulat bad_text, bad_color, bad_text_color o bad_position para sa mga value na hindi'hindi magkasya.

Ang button'ang state, para basahin:

Katangian
`Lia.mainButton.type`	`"main"` o `"secondary"`
`Lia.mainButton.text`	Ang kanyang label (`"Continue"` para sa pangunahing button at `"Cancel"` para sa secondary hanggang sa iyong itakda ang isang isa)
`Lia.mainButton.color`, `Lia.mainButton.textColor`	Ang iyong mga kulay, o `null`
`Lia.mainButton.isVisible`, `Lia.mainButton.isActive`
`Lia.mainButton.isProgressVisible`	Kung ang spinner nito ay ipapakita
`Lia.mainButton.hasShineEffect`
`Lia.mainButton.position`

#Lia.secondaryButton

Ang pangalawang pindutan sa ibaba. Ang pareho na mga paraan at katangian tulad ng Lia.mainButton; ang kanilang mga pag-click ay ang "secondaryButtonClicked" event.

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

#Mga pindutan ng header

#Lia.backButton

Isang back button sa simula ng Lia'ang header (sa fullscreen, Lia'ang floating Close ay naging back button). Gamitin ito para sa iyong sariling mga screen: ipakita ito kapag ang tao ay pumasok sa isang screen, at bumalik kapag ito's pressed. Lia hindi'hindi maaabot para sa iyo.

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

Paraan o property
`Lia.backButton.show()`	Nagpapakita nito. Babalik ang button.
`Lia.backButton.hide()`	Iiwasan ito.
`Lia.backButton.onClick(listener)`	Nakikinig sa isang pag-press (ang `"backButtonClicked"` event).
`Lia.backButton.offClick(listener)`	Nagtatapos ang pagbasa nito.
`Lia.backButton.isVisible`	Kung ito'ang ipinakita.

Habang ang back button ay ipinapakita sa fullscreen, ang mga tao ay i-close ang iyong app mula sa menu ⋯.

#Lia.settingsButton

Nagdaragdag ng mga setting sa iyong app's ⋯ menu. Pag-ukit nito ay ang "settingsButtonClicked" event. Ang parehong mga paraan tulad ng Lia.backButton.

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

Awtomatikong isinalin. Ang English ay ang source of truth. Basahin sa Ingles