SDK referencia

Expansión y pantalla completa, deslizamientos y confirmación de cierre, colores de encabezado y fondo de Lia, y los botones inferior, atrás y configuración.

#La hoja y pantalla completa

Ver Tres diseños para sheet, full y fullscreen.

#Lia.expand()

Como una hoja: ocupa toda la altura de la pantalla. Resuelve con { expanded: true } (también cuando ya estaba). Su página escucha un "viewport" evento con la nueva altura.

#Lia.requestFullscreen()

De borde a borde, con solo Lia'los botones Cerrar flotantes y ⋯ sobre tu página. Primero se expande una hoja. Se resuelve con { isFullscreen: true }, y tu página escucha "fullscreenChanged" con la nueva contentSafeArea. Mantén tu contenido por debajo Lia.contentSafeArea.top.

#Lia.exitFullscreen()

Vuelva de pantalla completa: a una hoja si su app se abrió como tal, de lo contrario a toda la pantalla bajo Lia's encabezado. Se resuelve con { isFullscreen: false }.

#Lia.disableExpand()

Como una hoja: mantiene su altura, por lo que levantarla ya no ocupa toda la pantalla. Lia.expand() todavía puede. Se resuelve con null.

#Lia.enableExpand()

Como una hoja: levantarla ocupa toda la pantalla nuevamente (por defecto).

#Lia.disableVerticalSwipes()

Como una hoja: un deslizamiento hacia abajo ya no la cierra. Apáguelo para juegos que usen deslizamientos. Resuelve con null.

#Lia.enableVerticalSwipes()

Como una hoja: un deslizamiento hacia abajo la cierra nuevamente (por defecto).

#Cierre

#Lia.enableClosingConfirmation()

Pregunta antes de cerrar, por trabajo no guardado o un juego en curso: cuando la persona cierra su app con Cerrar o desde el menú ⋯, Lia pregunta si quiere salir primero. Una hoja puede't ser cerrado con deslizar mientras está'en. Se resuelve con null.

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

Lia.close() desde tu propia página se cierra sin preguntar.

#Lia.disableClosingConfirmation()

Cierra sin preguntar de nuevo (por defecto).

#Colores

#Lia.setBackgroundColor(color)

El color detrás de tu página, y detrás de los botones inferiores. Se resuelve con null.

Errores: bad_color.

#Lia.setHeaderColor(color)

El color de Lia's encabezado sobre su aplicación. Su texto y botones se vuelven claros o oscuros para adaptarse. Se resuelve con null. Errores: bad_color.

Lia.setHeaderColor("#2F5BFF");

#Botones inferiores

#Lia.mainButton

Un botón ancho debajo de su página, en azul Lia a menos que lo pinte, como Telegram's MainButton. Lia.secondaryButton es otro segundo junto o encima de él, blanco (o Lia's color de tarjeta) con texto azul. Ambos están ocultos hasta que los muestra.

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

Cada método devuelve el botón, por lo que las llamadas se encadenan: Lia.mainButton.setText("Next").show().

setParams toma cualquiera de estos (Telegram'tus nombres o camelCase):

Lanza bad_text, bad_color, bad_text_color o bad_position para valores que no'ajustar.

El botón's estado, para leer:

#Lia.secondaryButton

El segundo botón inferior. Los mismos métodos y propiedades que Lia.mainButton; sus pulsaciones son las "secondaryButtonClicked" evento.

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

#Botones de encabezado

#Lia.backButton

Un botón de retroceso al inicio de Lia's encabezado (en pantalla completa, Lia'los botones Cerrar flotantes se convierten en un botón de retroceso). Úsalo para tus propias pantallas: muéstralo cuando la persona vaya una pantalla adentro, y vuelve atrás cuando lo'presionado. Lia no'no necesita navegar por usted.

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

Mientras que el botón Atrás se muestra en pantalla completa, las personas cierran tu app desde el menú ⋯.

#Lia.settingsButton

Añade Configuración a tu app's ⋯ menú. Presionarlo es el "settingsButtonClicked" evento. Los mismos métodos que Lia.backButton.

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

Traducido automáticamente. El inglés es la fuente de verdad. Leer en inglés