SDK référence

Expansions et plein écran, glissements et confirmation de fermeture, les couleurs de l'en-tête et du fond de Lia, et les boutons inférieurs, arrière et paramètres.

#La feuille et plein écran

Voir Trois apparences pour sheet, full et fullscreen.

#Lia.expand()

Sous forme de feuille : prend toute la hauteur de l'écran. Résout avec { expanded: true } (aussi quand c'était déjà le cas). Votre page entend un "viewport" événement avec la nouvelle hauteur.

#Lia.requestFullscreen()

De bord à bord, avec seulement Lia'flottant Fermer et ⋯ sur votre page. Une feuille s'ouvre d'abord. Résout avec { isFullscreen: true }, et votre page entend "fullscreenChanged" avec le nouveau contentSafeArea. Gardez votre contenu en dessous Lia.contentSafeArea.top.

#Lia.exitFullscreen()

De retour en plein écran : vers une feuille si votre application s'est ouverte comme telle, sinon vers l'écran entier sous Lia'en-tête. Résout avec { isFullscreen: false }.

#Lia.disableExpand()

Sous forme de feuille : conserve sa hauteur, donc tirer dessus ne prend plus l'écran entier. Lia.expand() peut encore le faire. Résout avec null.

#Lia.enableExpand()

Sous forme de feuille : tirer dessus prend à nouveau l'écran entier (par défaut).

#Lia.disableVerticalSwipes()

Sous forme de feuille : un glissement vers le bas ne la ferme plus. Désactivez cela pour les jeux qui utilisent des glissements. Résout avec null.

#Lia.enableVerticalSwipes()

Sous forme de feuille : un glissement vers le bas la ferme à nouveau (par défaut).

#Fermeture

#Lia.enableClosingConfirmation()

Demande avant de fermer, pour un travail non sauvegardé ou un jeu en cours : lorsqu'une personne ferme votre application avec Close ou depuis le menu ⋯, Lia demande si elle veut quitter en premier. Une feuille peut'ne pas être fermé par glissement pendant qu'il'sur. Résout avec null.

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

Lia.close() de votre page se ferme sans demander.

#Lia.disableClosingConfirmation()

Ferme sans demander à nouveau (par défaut).

#Couleurs

#Lia.setBackgroundColor(color)

La couleur derrière votre page, et derrière les boutons du bas. Résout avec null.

Erreurs : bad_color.

#Lia.setHeaderColor(color)

La couleur de Lia'en-tête au-dessus de votre application. Son texte et ses boutons passent en clair ou en sombre selon l'effet. Résout avec null. Erreurs : bad_color.

Lia.setHeaderColor("#2F5BFF");

#Boutons en bas

#Lia.mainButton

Un grand bouton sous votre page, en bleu Lia sauf si vous le colorisez, comme Telegram's MainButton. Lia.secondaryButton est un deuxième au côté ou au-dessus, blanc (ou Lia'la couleur de la carte) avec du texte bleu. Les deux sont masqués jusqu'à ce que vous les affichiez.

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

Chaque méthode renvoie le bouton, donc les appels sont en chaîne : Lia.mainButton.setText("Next").show().

setParams prend l'une de ces (Telegram'les noms ou camelCase) :

Il lance bad_text, bad_color, bad_text_color ou bad_position pour les valeurs qui ne'ça ne marche pas.

Le bouton'son état, pour lire :

#Lia.secondaryButton

Le deuxième bouton en bas. Les mêmes méthodes et propriétés que Lia.mainButton; ses appuis sont les "secondaryButtonClicked" événement.

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

#Boutons de l'en-tête

#Lia.backButton

Un bouton de retour au début de Lia'en-tête (en plein écran, Lia'flottant Fermer devient un bouton retour). Utilisez-le pour vos propres écrans : affichez-le lorsque la personne entre dans un écran, et revenez en arrière lorsqu'il'appuyé. Lia ne le fait pas'ne pas naviguer pour vous.

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

Tant que le bouton retour s'affiche en plein écran, les utilisateurs ferment votre application depuis le menu ⋯.

#Lia.settingsButton

Ajoutez les paramètres à votre application'menu ⋯. Appuyer dessus est le "settingsButtonClicked" événement. Les mêmes méthodes que Lia.backButton.

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

Traduit automatiquement. L'anglais est la source de vérité. Lire en anglais