Referensi SDK
Tata letak, warna dan tombol
Salin halaman
Ekspansi dan layar penuh, geser dan konfirmasi penutupan, warna header dan latar belakang Lia, serta tombol bawah, kembali, dan pengaturan.
#Lembar dan layar penuh
Lihat Tiga tampilan untuk sheet, full dan fullscreen.
#Lia.expand()
Sebagai lembar: mengambil ketinggian penuh layar. Menyelesaikan dengan { expanded: true } (juga ketika sudah begitu). Halaman Anda mendengar "viewport" acara dengan tinggi baru.
#Lia.requestFullscreen()
Sisi ke sisi, dengan hanya Lia'tombol Close dan ⋯ yang mengambang di atas halaman Anda. Sebuah sheet terlebih dahulu membesar. Menyelesaikan dengan { isFullscreen: true }, dan halaman Anda mendengar "fullscreenChanged" dengan yang baru contentSafeArea. Pertahankan konten Anda di bawah Lia.contentSafeArea.top.
#Lia.exitFullscreen()
Kembali dari layar penuh: ke lembar jika aplikasi Anda dibuka sebagai lembar, selain itu kembali ke seluruh layar di bawah Lia'header. Menyelesaikan dengan { isFullscreen: false }.
#Lia.disableExpand()
Sebagai lembar: menjaga tingginya, sehingga menariknya ke atas tidak lagi mengambil seluruh layar. Lia.expand() masih bisa. Menyelesaikan dengan null.
#Lia.enableExpand()
Sebagai lembar: menariknya ke atas mengambil seluruh layar lagi (default).
#Lia.disableVerticalSwipes()
Sebagai lembar: geser ke bawah tidak lagi menutupnya. Matikan ini untuk permainan yang menggunakan geser. Menyelesaikan dengan null.
#Lia.enableVerticalSwipes()
Sebagai lembar: geser ke bawah untuk menutupnya kembali (default).
#Menutup
#Lia.enableClosingConfirmation()
Menanyakan sebelum menutup, untuk pekerjaan yang belum disimpan atau permainan yang sedang berlangsung: ketika orang menutup aplikasi Anda dengan Tutup atau dari menu ⋯, Lia menanyakan apakah ingin pergi terlebih dahulu. Sebuah lembar dapat't ditutup dengan geser sementara itu'diaktifkan. Menyelesaikan dengan null.
Lia.enableClosingConfirmation(); // when a match starts
Lia.disableClosingConfirmation(); // when it endsLia.close() dari halaman Anda sendiri yang ditutup tanpa bertanya.
#Lia.disableClosingConfirmation()
Menutup tanpa bertanya lagi (default).
#Warna
#Lia.setBackgroundColor(color)
Warna di belakang halaman Anda, dan di belakang tombol bawah. Menyelesaikan dengan null.
| Parameter | Jenis | |
|---|---|---|
color | string | #RRGGBB, seperti "#E9EEFF". |
Kesalahan: bad_color.
#Lia.setHeaderColor(color)
Warna dari Lia'header di atas aplikasimu. Teks dan tombolnya berubah terang atau gelap sesuai kebutuhan. Menyelesaikan dengan null. Kesalahan: bad_color.
Lia.setHeaderColor("#2F5BFF");#Tombol bawah
#Lia.mainButton
Sebuah tombol lebar di bawah halaman Anda, dalam biru Lia kecuali Anda mewarnainya, seperti Telegram's MainButton. Lia.secondaryButton adalah yang kedua di samping atau di atasnya, putih (atau Lia'warna kartu) dengan teks biru. Keduanya disembunyikan hingga Anda menampilkannya.
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(); }
});Setiap metode mengembalikan tombol, sehingga panggilan berantai: Lia.mainButton.setText("Next").show().
| Metode | Apa yang dilakukannya |
|---|---|
Lia.mainButton.setText(text) | Labelnya, hingga 64 karakter. Melemparkan bad_text. |
Lia.mainButton.setParams(params) | Beberapa sekaligus (di bawah). |
Lia.mainButton.show() | Menunjukkan itu. |
Lia.mainButton.hide() | Menyembunyikannya. |
Lia.mainButton.enable() | Memungkinkannya untuk ditekan. |
Lia.mainButton.disable() | Mengaburkannya. |
Lia.mainButton.showProgress(leaveActive) | Sebuah spinner di tempat labelnya. Itu'dinonaktifkan saat berputar, kecuali leaveActive adalah true. |
Lia.mainButton.hideProgress() | Labelnya lagi, dan aktif. |
Lia.mainButton.onClick(listener) | Mendengar tekanan. |
Lia.mainButton.offClick(listener) | Menghentikan mendengarnya. |
setParams menerima salah satu ini (Telegram'nama-nama atau camelCase):
| Param | Jenis | |
|---|---|---|
text | string | Maksimal 64 karakter. |
color | string atau null | #RRGGBB, atau null untuk Lia's. |
text_color atau textColor | string atau null | #RRGGBB, atau null untuk Lia's. |
is_visible atau isVisible | boolean | |
is_active atau isActive | boolean | |
has_shine_effect atau hasShineEffect | boolean | Diterima, tetapi Lia tidak'tidak menggambar kilauan belum. |
position | string | Untuk tombol sekunder: di mana ia berada di samping yang utama, "left" (default), "right", "top" atau "bottom". |
Ini melemparkan bad_text, bad_color, bad_text_color atau bad_position untuk nilai-nilai yang tidak'tidak cocok.
Tombol'keadaan s, untuk membaca:
| Properti | |
|---|---|
Lia.mainButton.type | "main" atau "secondary" |
Lia.mainButton.text | Labelnya ("Continue" untuk tombol utama dan "Cancel" untuk sekunder hingga Anda menetapkan satu) |
Lia.mainButton.color, Lia.mainButton.textColor | Warna Anda, atau null |
Lia.mainButton.isVisible, Lia.mainButton.isActive | |
Lia.mainButton.isProgressVisible | Apakah spinner-nya ditampilkan |
Lia.mainButton.hasShineEffect | |
Lia.mainButton.position |
#Lia.secondaryButton
Tombol bawah kedua. Metode dan properti yang sama seperti Lia.mainButton; tekanan-tekanannya adalah "secondaryButtonClicked" acara.
Lia.secondaryButton.setParams({ text: "Skip", is_visible: true, position: "left" }).onClick(skip);#Tombol header
#Lia.backButton
Tombol kembali di awal Lia'header (dalam mode layar penuh, Lia'tombol Close menjadi tombol kembali). Gunakan untuk layar Anda sendiri: tampilkan saat seseorang masuk satu layar, dan kembali saat itu'ditekan. Lia tidak'tidak dapat menavigasi untuk Anda.
function openDetail(item) {
showDetail(item);
Lia.backButton.show();
}
Lia.backButton.onClick(function () {
showList();
Lia.backButton.hide();
});| Metode atau properti | |
|---|---|
Lia.backButton.show() | Menunjukkan itu. Mengembalikan tombol. |
Lia.backButton.hide() | Menyembunyikannya. |
Lia.backButton.onClick(listener) | Mendengar tekanan (yaitu "backButtonClicked" acara). |
Lia.backButton.offClick(listener) | Menghentikan mendengarnya. |
Lia.backButton.isVisible | Apakah itu'ditampilkan. |
Sementara tombol kembali ditampilkan dalam mode layar penuh, orang-orang menutup aplikasi Anda dari menu ⋯.
#Lia.settingsButton
Menambahkan Pengaturan ke aplikasi Anda'menu. Menekannya adalah "settingsButtonClicked" acara. Metode yang sama seperti Lia.backButton.
Lia.settingsButton.show().onClick(openSettings);Diterjemahkan otomatis. Bahasa Inggris adalah sumber kebenaran. Baca dalam Bahasa Inggris