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

在有未保存的工作或进行中的游戏时询问关闭：当用户使用关闭或从⋯菜单关闭您的应用时，Lia会先询问是否要离开。表格可以't 被滑动关闭，而它'页面上的。以以下方式解决 null.

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

Lia.close() 从你的页面关闭而无需询问。

#Lia.disableClosingConfirmation()

关闭而不再次询问（默认）。

#颜色

#Lia.setBackgroundColor(color)

你页面背后的颜色，以及底部按钮背后的颜色。以 null.

参数	类型
`color`	字符串	`#RRGGBB`，比如 `"#E9EEFF"`.

错误： 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().

方法	它做什么
`Lia.mainButton.setText(text)`	它的标签，最多64个字符。抛出 `bad_text`.
`Lia.mainButton.setParams(params)`	一次多个（如下）。
`Lia.mainButton.show()`	显示它。
`Lia.mainButton.hide()`	隐藏它。
`Lia.mainButton.enable()`	让它被按下。
`Lia.mainButton.disable()`	变灰。
`Lia.mainButton.showProgress(leaveActive)`	用其标签代替的旋转器。它'的禁用状态，除非 `leaveActive` 是 `true`.
`Lia.mainButton.hideProgress()`	它的标签再次出现，并且已启用。
`Lia.mainButton.onClick(listener)`	听到一个按压。
`Lia.mainButton.offClick(listener)`	停止听到它。

setParams 需要这些中的任何一个（Telegram'的名字或camelCase)：

参数	类型
`text`	字符串	最多64 个字符。
`color`	字符串或空值	`#RRGGBB`，或者 `null` 对于 Lia's.
`text_color` 或 `textColor`	字符串或空值	`#RRGGBB`，或者 `null` 对于 Lia's.
`is_visible` 或 `isVisible`	布尔值
`is_active` 或 `isActive`	布尔值
`has_shine_effect` 或 `hasShineEffect`	布尔值	已接受，但 Lia 不'不要让它有光泽。
`position`	字符串	对于次要按钮：它与主按钮相邻的位置 `"left"` （默认）， `"right"`, `"top"` 或 `"bottom"`.

它会抛出 bad_text, bad_color, bad_text_color 或 bad_position 用于值的，不要'不要适合。

按钮'的状态，要读取：

属性
`Lia.mainButton.type`	`"main"` 或 `"secondary"`
`Lia.mainButton.text`	它的标签（`"Continue"` 用于主按钮和 `"Cancel"` 用于次要按钮，直到您设置一个)
`Lia.mainButton.color`, `Lia.mainButton.textColor`	您的颜色，或者 `null`
`Lia.mainButton.isVisible`, `Lia.mainButton.isActive`
`Lia.mainButton.isProgressVisible`	它的加载指示器是否显示
`Lia.mainButton.hasShineEffect`
`Lia.mainButton.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.backButton.show()`	显示它。返回按钮。
`Lia.backButton.hide()`	隐藏它。
`Lia.backButton.onClick(listener)`	听到一个按压（ `"backButtonClicked"` 事件）。
`Lia.backButton.offClick(listener)`	停止听到它。
`Lia.backButton.isVisible`	它是否'显示。

当全屏时，返回按钮显示，人们会从⋯菜单中关闭你的应用。

#Lia.settingsButton

为您的应用添加设置'的⋯菜单。按下它是 "settingsButtonClicked" 事件；与之相同的方法 Lia.backButton.

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

自动翻译。英语是真实来源。阅读英文