Tham khảo SDK

Bố cục, màu sắc và nút

Sao chép trang

Mở rộng và toàn màn hình, vuốt và xác nhận đóng, màu sắc tiêu đề và nền của Lia, và các nút dưới, quay lại và cài đặt.

#Bảng tính và chế độ toàn màn hình

Xem Ba kiểu dáng cho sheet, full và fullscreen.

#Lia.expand()

Như một bảng: chiếm toàn bộ chiều cao của màn hình. Trả về { expanded: true } (cũng khi nó đã tồn tại). Trang web của bạn nhận được một "viewport" sự kiện với chiều cao mới.

#Lia.requestFullscreen()

Từ cạnh này sang cạnh kia, chỉ có Lia'các nút Close và ⋯ trôi nổi trên trang của bạn. Một tấm bảng mở ra trước. Trả về { isFullscreen: true }, và trang web của bạn nghe thấy "fullscreenChanged" với mới contentSafeArea. Giữ nội dung của bạn dưới Lia.contentSafeArea.top.

#Lia.exitFullscreen()

Quay lại từ chế độ toàn màn hình: về bảng nếu ứng dụng của bạn mở dưới dạng bảng, nếu không thì về toàn bộ màn hình dưới Lia'tiêu đề của nó. Giải quyết với { isFullscreen: false }.

#Lia.disableExpand()

Như một bảng: giữ chiều cao của nó, vì vậy kéo nó lên không còn chiếm toàn bộ màn hình. Lia.expand() vẫn có thể. Giải quyết với null.

#Lia.enableExpand()

Như một bảng: kéo nó lên chiếm toàn bộ màn hình lại (mặc định).

#Lia.disableVerticalSwipes()

Như một bảng: một cử chỉ vuốt xuống không còn đóng nó nữa. Tắt tính năng này cho các trò chơi sử dụng cử chỉ vuốt. Trả về null.

#Lia.enableVerticalSwipes()

Như một bảng: một cử chỉ vuốt xuống sẽ đóng nó lại (mặc định).

#Đóng

#Lia.enableClosingConfirmation()

Hỏi trước khi đóng, đối với công việc chưa lưu hoặc trò chơi đang diễn ra: khi người dùng đóng ứng dụng của bạn bằng Close hoặc từ menu ⋯, Lia hỏi xem có muốn rời trước không. Một bảng có thể't được vuốt đóng trong khi nó'trên. Giải quyết với null.

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

Lia.close() từ trang của bạn đóng lại mà không hỏi.

#Lia.disableClosingConfirmation()

Đóng mà không hỏi lại (mặc định).

#Màu sắc

#Lia.setBackgroundColor(color)

Màu sắc phía sau trang của bạn, và phía sau các nút dưới cùng. Giải quyết với null.

Tham số	Loại
`color`	chuỗi	`#RRGGBB`, như `"#E9EEFF"`.

Lỗi: bad_color.

#Lia.setHeaderColor(color)

Màu sắc của Lia'tiêu đề trên ứng dụng của bạn. Văn bản và nút của nó chuyển sang sáng hoặc tối để phù hợp. Trả về null. Lỗi: bad_color.

Lia.setHeaderColor("#2F5BFF");

#Nút dưới cùng

#Lia.mainButton

Một nút rộng dưới trang của bạn, màu xanh Lia trừ khi bạn tô màu nó, giống như Telegram's MainButton. Lia.secondaryButton là một cái khác bên cạnh hoặc phía trên nó, màu trắng (hoặc Lia'màu thẻ) với văn bản màu xanh. Cả hai đều bị ẩn cho đến khi bạn hiển thị chúng.

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

Mỗi phương pháp trả về nút, vì vậy các cuộc gọi được nối tiếp: Lia.mainButton.setText("Next").show().

Phương pháp	Cái gì nó làm
`Lia.mainButton.setText(text)`	Nhãn của nó, lên đến 64 ký tự. Ném `bad_text`.
`Lia.mainButton.setParams(params)`	Nhiều cái cùng lúc (dưới đây).
`Lia.mainButton.show()`	Hiển thị nó.
`Lia.mainButton.hide()`	Ẩn nó.
`Lia.mainButton.enable()`	Cho phép nó được nhấn.
`Lia.mainButton.disable()`	Làm mờ nó.
`Lia.mainButton.showProgress(leaveActive)`	Một vòng quay thay cho nhãn của nó. Nó'bị vô hiệu hóa khi nó quay, trừ khi `leaveActive` là `true`.
`Lia.mainButton.hideProgress()`	Nhãn của nó lần nữa, và được kích hoạt.
`Lia.mainButton.onClick(listener)`	Nghe một lần nhấn.
`Lia.mainButton.offClick(listener)`	Dừng nghe nó.

setParams nhận bất kỳ cái nào trong số này (Telegram'tên hoặc camelCase):

Tham số	Loại
`text`	chuỗi	Tối đa 64 ký tự.
`color`	chuỗi hoặc null	`#RRGGBB`, hoặc `null` cho Lia's.
`text_color` hoặc `textColor`	chuỗi hoặc null	`#RRGGBB`, hoặc `null` cho Lia's.
`is_visible` hoặc `isVisible`	boolean
`is_active` hoặc `isActive`	boolean
`has_shine_effect` hoặc `hasShineEffect`	boolean	Được chấp nhận, nhưng Lia không'chưa tạo ra ánh sáng yet.
`position`	chuỗi	Đối với nút phụ: nơi nó nằm cạnh nút chính, `"left"` (mặc định), `"right"`, `"top"` hoặc `"bottom"`.

Nó ném ra bad_text, bad_color, bad_text_color hoặc bad_position cho các giá trị mà không'phù hợp.

Nút'trạng thái, để đọc:

Tính chất
`Lia.mainButton.type`	`"main"` hoặc `"secondary"`
`Lia.mainButton.text`	Nhãn của nó (`"Continue"` cho nút chính và `"Cancel"` cho nút phụ cho đến khi bạn thiết lập một cái)
`Lia.mainButton.color`, `Lia.mainButton.textColor`	Màu sắc của bạn, hoặc `null`
`Lia.mainButton.isVisible`, `Lia.mainButton.isActive`
`Lia.mainButton.isProgressVisible`	Liệu bộ phận quay có hiển thị
`Lia.mainButton.hasShineEffect`
`Lia.mainButton.position`

#Lia.secondaryButton

Nút dưới cùng thứ hai. Cùng các phương thức và thuộc tính như Lia.mainButton; các lần nhấn của nó là "secondaryButtonClicked" sự kiện.

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

#Nút tiêu đề

#Lia.backButton

Một nút quay lại ở đầu Lia'tiêu đề (trong chế độ toàn màn hình, Lia'các nút Close trôi nổi trở thành nút quay lại). Sử dụng nó cho các màn hình riêng của bạn: hiển thị khi người dùng vào một màn hình, và quay lại khi nó'được nhấn. Lia không'để bạn dễ dàng điều hướng.

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

Phương pháp hoặc thuộc tính
`Lia.backButton.show()`	Hiển thị nó. Trả về nút.
`Lia.backButton.hide()`	Ẩn nó.
`Lia.backButton.onClick(listener)`	Nghe một lần nhấn (đó là `"backButtonClicked"` sự kiện).
`Lia.backButton.offClick(listener)`	Dừng nghe nó.
`Lia.backButton.isVisible`	Có phải nó'được hiển thị.

Trong khi nút quay lại hiển thị ở chế độ toàn màn hình, người dùng đóng ứng dụng của bạn từ menu ⋯.

#Lia.settingsButton

Thêm cài đặt vào ứng dụng của bạn'mà menu ⋯. Nhấn vào đó là "settingsButtonClicked" sự kiện. Các phương thức giống như Lia.backButton.

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

Được dịch tự động. Tiếng Anh là nguồn tin cậy. Đọc bằng tiếng Anh