Referência SDK
Layout, cores e botões
Copiar página
Expansão e tela cheia, deslizes e confirmação de fechar, cores do cabeçalho e fundo de Lia, e os botões inferior, voltar e configurações.
#A planilha e tela cheia
Ver Três aparências para sheet, full e fullscreen.
#Lia.expand()
Como uma folha: ocupa a altura total da tela. Resolve com { expanded: true } (também quando já estava). Sua página ouve um "viewport" evento com a nova altura.
#Lia.requestFullscreen()
De borda a borda, com apenas Lia'botões Flutuantes Close e ⋯ sobre sua página. Uma folha se expande primeiro. Resolve com { isFullscreen: true }, e sua página ouve "fullscreenChanged" com o novo contentSafeArea. Mantenha seu conteúdo abaixo Lia.contentSafeArea.top.
#Lia.exitFullscreen()
De volta para tela cheia: para uma folha se seu app foi aberto como uma, caso contrário para a tela inteira sob Lia'cabeçalho. Resolve com { isFullscreen: false }.
#Lia.disableExpand()
Como uma folha: mantém sua altura, então puxá-la para cima não ocupa mais toda a tela. Lia.expand() ainda pode. Resolve com null.
#Lia.enableExpand()
Como uma folha: puxá-la para cima ocupa toda a tela novamente (o padrão).
#Lia.disableVerticalSwipes()
Como uma folha: um toque para baixo não fecha mais. Desative isso para jogos que usam toques. Resolve com null.
#Lia.enableVerticalSwipes()
Como uma folha: um toque para baixo a fecha novamente (o padrão).
#Fechando
#Lia.enableClosingConfirmation()
Pergunta antes de fechar, para trabalho não salvo ou um jogo em andamento: quando a pessoa fecha seu app com Fechar ou do menu ⋯, Lia pergunta se deve sair primeiro. Uma folha pode'não seja fechado por swipar enquanto ele's ativo. Resolve com null.
Lia.enableClosingConfirmation(); // when a match starts
Lia.disableClosingConfirmation(); // when it endsLia.close() de sua página se fecha sem perguntar.
#Lia.disableClosingConfirmation()
Fecha sem perguntar novamente (o padrão).
#Cores
#Lia.setBackgroundColor(color)
A cor atrás da sua página, e atrás dos botões inferiores. Resolve com null.
| Parâmetro | Tipo | |
|---|---|---|
color | string | #RRGGBB, como "#E9EEFF". |
Erros: bad_color.
#Lia.setHeaderColor(color)
A cor de Lia'cabeçalho sobre seu app. Seu texto e botões mudam para claro ou escuro conforme necessário. Resolve com null. Erros: bad_color.
Lia.setHeaderColor("#2F5BFF");#Botões inferiores
#Lia.mainButton
Um botão largo sob a sua página, em azul Lia a menos que você o colori, como o Telegram'no MainButton. Lia.secondaryButton é um segundo ao lado ou acima dele, branco (ou Lia'cor da carta) com texto azul. Ambos são ocultos até você mostrá-los.
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(); }
});Todo método retorna o botão, então as chamadas são encadeadas: Lia.mainButton.setText("Next").show().
| Método | O que ele faz |
|---|---|
Lia.mainButton.setText(text) | Seu rótulo, até 64 caracteres. Lança bad_text. |
Lia.mainButton.setParams(params) | Vários de uma vez (abaixo). |
Lia.mainButton.show() | Mostra isso. |
Lia.mainButton.hide() | Oculta-o. |
Lia.mainButton.enable() | Permite que seja pressionado. |
Lia.mainButton.disable() | Torna cinza. |
Lia.mainButton.showProgress(leaveActive) | Um indicador no lugar do seu rótulo. Ele'desativado enquanto gira, a menos que leaveActive é true. |
Lia.mainButton.hideProgress() | Seu rótulo novamente, e habilitado. |
Lia.mainButton.onClick(listener) | Ouve uma pressão. |
Lia.mainButton.offClick(listener) | Para de ouvi-lo. |
setParams toma qualquer um desses (Telegram's nomes ou camelCase):
| Param | Tipo | |
|---|---|---|
text | string | Até 64 caracteres. |
color | string ou nulo | #RRGGBB, ou null para Lia's. |
text_color ou textColor | string ou nulo | #RRGGBB, ou null para Lia's. |
is_visible ou isVisible | booleano | |
is_active ou isActive | booleano | |
has_shine_effect ou hasShineEffect | booleano | Aceito, mas Lia não'não desenhar um brilho ainda. |
position | string | Para o botão secundário: onde ele fica ao lado do principal, "left" (o padrão), "right", "top" ou "bottom". |
Ele lança bad_text, bad_color, bad_text_color ou bad_position para valores que não'não caber.
O botão'estado, para ler:
| Propriedade | |
|---|---|
Lia.mainButton.type | "main" ou "secondary" |
Lia.mainButton.text | Seu rótulo ("Continue" para o botão principal e "Cancel" para o secundário até você definir um) |
Lia.mainButton.color, Lia.mainButton.textColor | Suas cores, ou null |
Lia.mainButton.isVisible, Lia.mainButton.isActive | |
Lia.mainButton.isProgressVisible | Se o seu indicador de carregamento aparece |
Lia.mainButton.hasShineEffect | |
Lia.mainButton.position |
#Lia.secondaryButton
O segundo botão inferior. Os mesmos métodos e propriedades que Lia.mainButton; seus toques são os "secondaryButtonClicked" evento.
Lia.secondaryButton.setParams({ text: "Skip", is_visible: true, position: "left" }).onClick(skip);#Botões do cabeçalho
#Lia.backButton
Um botão de voltar no início do Lia'cabeçalho (em tela cheia, Lia'flutuante Close se torna um botão de voltar). Use-o para suas próprias telas: mostre-o quando a pessoa entra em uma tela, e volte quando ele'pressionado. Lia não'navegar por você.
function openDetail(item) {
showDetail(item);
Lia.backButton.show();
}
Lia.backButton.onClick(function () {
showList();
Lia.backButton.hide();
});| Método ou propriedade | |
|---|---|
Lia.backButton.show() | Mostra isso. Retorna o botão. |
Lia.backButton.hide() | Oculta-o. |
Lia.backButton.onClick(listener) | Ouve uma pressão (a "backButtonClicked" evento). |
Lia.backButton.offClick(listener) | Para de ouvi-lo. |
Lia.backButton.isVisible | Se ele'exibido. |
Enquanto o botão de voltar estiver visível em tela cheia, as pessoas fecham seu aplicativo pelo menu ⋯.
#Lia.settingsButton
Adiciona configurações ao seu app'menu ⋯. Pressioná-lo é o "settingsButtonClicked" evento. Os mesmos métodos que Lia.backButton.
Lia.settingsButton.show().onClick(openSettings);Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês