SDK справка

Расширение и полноэкранный режим, свайпы и подтверждение закрытия, цвета заголовка и фона Lia, а также кнопки внизу, назад и настроек.

#Лист и полноэкранный режим

Смотреть Три вида для sheet, full и fullscreen.

#Lia.expand()

Как лист: занимает полную высоту экрана. Возвращает { expanded: true } (также когда это уже было). Ваша страница слышит "viewport" событие с новой высотой.

#Lia.requestFullscreen()

От края до края, с только Lia'плавающие кнопки Закрыть и ⋯ над вашей страницей. Сначала раскрывается вкладка. Возвращает { isFullscreen: true }, и ваша страница слышит "fullscreenChanged" с новым contentSafeArea. Держите ваш контент ниже Lia.contentSafeArea.top.

#Lia.exitFullscreen()

Вернуться из полноэкранного режима: в лист, если ваше приложение открылось как лист, иначе в целый экран под Lia'заголовок. Решается с { isFullscreen: false }.

#Lia.disableExpand()

Как лист: сохраняет свою высоту, поэтому тянуть его вверх больше не занимает весь экран. Lia.expand() по-прежнему может. Решается с null.

#Lia.enableExpand()

Как лист: тянуть его вверх занимает весь экран снова (по умолчанию).

#Lia.disableVerticalSwipes()

Как лист: свайп вниз больше не закрывает его. Отключите это для игр, использующих свайпы. Возвращает null.

#Lia.enableVerticalSwipes()

Как лист: свайп вниз закрывает его снова (по умолчанию).

#Закрытие

#Lia.enableClosingConfirmation()

Спрашивает перед закрытием, для несохраненных данных или игры в процессе: когда человек закрывает ваше приложение с Close или из меню ⋯, Lia спрашивает, хочет ли он уйти сначала. Лист может't быть свайпнутым закрытым, пока оно'включено. Решается с помощью null.

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

Lia.close() с вашей собственной страницы закрывается без вопроса.

#Lia.disableClosingConfirmation()

Закрывает без повторного вопроса (по умолчанию).

#Цвета

#Lia.setBackgroundColor(color)

Цвет за вашей страницей и за кнопками внизу. Решается с null.

Ошибки: bad_color.

#Lia.setHeaderColor(color)

Цвет Lia'заголовка над вашим приложением. Его текст и кнопки становятся светлыми или темными, чтобы подойти. Решается с null. Ошибки: bad_color.

Lia.setHeaderColor("#2F5BFF");

#Нижние кнопки

#Lia.mainButton

Широкая кнопка под вашей страницей, в Lia синем, если вы не окрасите ее, как Telegram's MainButton. Lia.secondaryButton это вторая, рядом или над ней, белая (или Lia'цвет карты) с синим текстом. Оба скрыты, пока вы их не покажете.

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

Каждый метод возвращает кнопку, поэтому вызовы цепочкой: Lia.mainButton.setText("Next").show().

setParams берёт любые из этих (Telegram'имена или camelCase):

Оно вызывает исключение bad_text, bad_color, bad_text_color или bad_position для значений, которые не'не помещается.

Кнопка'состояние, чтобы прочитать:

#Lia.secondaryButton

Вторая нижняя кнопка. Те же методы и свойства, что и Lia.mainButton; их нажатия - это "secondaryButtonClicked" событие.

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

#Кнопки заголовка

#Lia.backButton

Кнопка возврата в начале Lia'заголовок (в полноэкранном режиме, Lia'плавающая кнопка Закрыть становится кнопкой Назад). Используйте ее для своих экранов: покажите, когда человек переходит на один экран, и вернитесь, когда она'ваше нажатие. Lia не'не могут навигировать за вас.

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

Пока кнопка возврата отображается в полноэкранном режиме, люди закрывают ваше приложение из меню ⋯.

#Lia.settingsButton

Добавляет настройки в ваше приложение's ⋯ меню. Нажатие на него - это "settingsButtonClicked" событие. Те же методы, что и Lia.backButton.

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

Автоматически переведено. Английский — источник истины. Читать на английском