LiaNhà phát triển

Khái niệm

Làm ứng dụng của bạn cảm giác như một phần của Lia. Các biến Lia của CSS, vùng xem và khu vực an toàn, ngôn ngữ của người dùng và văn bản từ phải sang trái, và âm thanh mà họ có thể tắt.

#Lia'mà chủ đề

Lia truyền màu sắc của nó cho trang của bạn, sáng hoặc tối, tùy theo người dùng có Lia được thiết lập. Sau Lia.init() họ'tham chiếu các biến CSS trên trang của bạn'căn bản, được giữ cập nhật khi người dùng chuyển đổi:

body {
  background: var(--lia-bg-color);
  color: var(--lia-text-color);
}
.card { background: var(--lia-secondary-bg-color); }
.hint { color: var(--lia-hint-color); }
button.primary { background: var(--lia-button-color); color: var(--lia-button-text-color); }
BiếnTừ Lia.themeCái gì nó là
--lia-bg-colorbg_colorTrang'nền
--lia-text-colortext_colorVăn bản
--lia-hint-colorhint_colorVăn bản nhẹ nhàng hơn
--lia-link-colorlink_colorLiên kết (Lia xanh)
--lia-button-colorbutton_colorNút (Lia màu xanh)
--lia-button-text-colorbutton_text_colorVăn bản trên nút
--lia-secondary-bg-colorsecondary_bg_colorThẻ và giếng
--lia-header-bg-colorheader_bg_colorLia'tiêu đề
--lia-bottom-bar-bg-colorbottom_bar_bg_colorNằm phía sau các nút dưới cùng
--lia-accent-text-coloraccent_text_colorVăn bản có dấu
--lia-section-bg-colorsection_bg_colorPhần
--lia-section-header-text-colorsection_header_text_colorTiêu đề phần
--lia-subtitle-text-colorsubtitle_text_colorChú thích
--lia-destructive-text-colordestructive_text_colorHành động phá hủy
--lia-section-separator-colorsection_separator_colorĐường viền tóc
--lia-color-schemeLia.colorSchemelight hoặc dark

Tên tuân theo Telegram'mà tham số chủ đề, vì vậy mã được viết cho ứng dụng mini Telegram có thể chuyển đổi. Nghe để theme sự kiện để vẽ lại bất cứ thứ gì bạn tự vẽ (một bảng vẽ, ví dụ).

Bạn cũng có thể đặt màu sắc phía sau trang của bạn và của Lia'tiêu đề với Lia.setBackgroundColor và Lia.setHeaderColor.

#Khu vực xem

Lia.viewport là { height, expanded }: chiều cao trang của bạn tính bằng px, và liệu một tấm bìa có được kéo lên đầy chiều cao hay không. Cái viewport sự kiện xảy ra khi nó thay đổi (bảng được kéo lên, nút dưới được hiển thị), và --lia-viewport-height giữ chiều cao.

#Khu vực an toàn

Điện thoại có notch và thanh home. Lia truyền chúng như Lia.safeArea và CSS biến số, theo px:

BiếnCái gì nó là
--lia-safe-area-inset-top, -bottom, -left, -rightĐiện thoại'khu vực an toàn riêng của bạn (Lia.safeArea)
--lia-content-safe-area-inset-top, -bottom, -left, -rightSạch sẽ Lia'các nút Close và ⋯ trôi nổi trong chế độ toàn màn hình nữa (Lia.contentSafeArea)

Trong một bảng tính hoặc dưới Lia'của tiêu đề, bạn chủ yếu cần phần dưới. Trong chế độ toàn màn hình, hãy giữ nội dung bên dưới khu vực an toàn cho nội dung'mà đầu:

.app {
  padding-top: var(--lia-content-safe-area-inset-top, 0px);
  padding-bottom: var(--lia-safe-area-inset-bottom, 0px);
}

#Ngôn ngữ

Lia.language là ngôn ngữ mà người đó sử dụng Lia trong, một trong số Lia's 13:

MãNgôn ngữMãNgôn ngữ
enTiếng AnhidTiếng Indonesia
esTiếng Tây Ban NhafilTiếng Philippines
ptTiếng Bồ Đào NhaswKiswahili
frTiếng Pháphiहिन्दी
trTiếng Thổ Nhĩ KỳarTiếng Ả Rập (từ phải sang trái)
ruРусскийzh中文
viTiếng Việt

Hiển thị ứng dụng của bạn'từ riêng của bạn trong đó. SDK thiết lập trang của bạn's lang cho bạn; Lia.rtl nói xem ngôn ngữ có được đọc từ trái sang phải hay không, vì vậy bạn phải thiết lập hướng tự mình:

Lia.init().then(function () {
  document.documentElement.dir = Lia.rtl ? "rtl" : "ltr";
  render(WORDS[Lia.language] || WORDS.en);
  Lia.ready();
});
Lia.on("languageChanged", function (data) {
  document.documentElement.dir = data.rtl ? "rtl" : "ltr";
  render(WORDS[data.language] || WORDS.en);
});

#Âm thanh

Mọi người có thể tắt âm ứng dụng của bạn từ Lia'mà menu ⋯, và Lia sẽ nhớ nó cho ứng dụng của bạn. Lia.soundOn nói xem họ có muốn âm thanh của bạn, và soundChanged nói khi nó thay đổi. Phát âm thanh chỉ khi nó'trên.

let soundOn = Lia.soundOn;
Lia.on("soundChanged", function (data) {
  soundOn = data.on;
  if (!soundOn) music.pause();
});
function play(sound) { if (soundOn) sound.play(); }

Trang của bạn có thể phát âm thanh mà không cần chạm đầu tiên. Để kết hợp với âm nhạc đang phát trên điện thoại thay vì dừng nó, hãy đặt navigator.audioSession.type = "ambient" nơi điện thoại hỗ trợ (Lia'trò chơi riêng của họ do).

#Nền tảng

Lia.platform là ios hoặc android sau init(). Lia'khung là điện thoại'trình duyệt web riêng của bạn: Safari'trên iPhone, Chrome'trên Android.

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

Nhập để tìm kiếm trên mọi trang, phương pháp và điểm cuối.