Karty

Dodatek na karcie wyświetla się jako panel na pasku bocznym (na urządzeniu mobilnym jako kolejny okno aktywności dostępne w menu). Dodatek ma górny pasek narzędzi, identyfikuje dodatek i wyświetla kartę, czyli „stronę”. z w interfejsie dodatku. Apps Script prezentuje karty w kodzie projektu za pomocą Card obiektów.

Anatomia karty

Przykładowa karta dodatku

Karta to grupa projektowanych przez Ciebie elementów interfejsu. Karta składa się z: w tych sekcjach:

  • Nagłówek karty. Identyfikuje ono karty. Ma tytuł i może mogą mieć podtytuł i ikonę.
  • Co najmniej jedna sekcja karty Są to części interfejsu karty. Sekcja może opcjonalnie mieć tekstowy nagłówek sekcji. Sekcje karty są oddzielone poziomą linijką. Jeśli sekcja karty jest wyjątkowo duża, jest ona automatycznie renderowana jako zwijaną sekcję, którą użytkownicy mogą rozwijać i zwijać odpowiednio do potrzeb. Karta może mieć maksymalnie 100 sekcji, i powinno ich mieć tylko kilka, aby zwiększyć skuteczność.

  • Każda sekcja karty zawiera co najmniej 1 UI widżety. Widżety oferują użytkownikom informacji i interaktywnych elementów sterujących. Sekcje kart są widżety strukturalne, więc nie można ich dodawać do sekcji karty. Kartę może zawierać nie więcej niż 100 widżetów, i powinny być jak najprostsze, aby zapewnić jak największą skuteczność.

Karty należy projektować na podstawie określonych działań użytkownika lub zbiorów danych. Dla: na przykład dodatek do Google Workspace, który wyświetla dane pobrane z Arkuszy Google mogą mieć osobną kartę dla każdego pobieranego arkusza .

Korzystanie z wielu kart

Przykładowa karta dodatku

Dodatki składają się zwykle z więcej niż jednej karty. Możesz je skonfigurować jako prostą listę, podstawowej nawigacji z wieloma kartami, lub skonfigurować bardziej złożone metody nawigacji aby kontrolować, jak użytkownik porusza się między kartami.

Jeśli dodatek korzysta z podstawowej nawigacji, Aplikacja Google Workspace, którą rozszerza, tworzy listę nagłówków kart i wyświetla je użytkownikowi. klikając kartę, nagłówek otwiera tę kartę. Dostępna jest też strzałka wstecz, która pozwala wrócić do karty. listę nagłówków. Nie musisz kodować nagłówka ani strzałki wstecz funkcji – dzieje się to automatycznie po zdefiniowaniu kart w sekcji Google Analytics.

Podczas projektowania dodatków najlepiej ogranicz liczbę kart wyświetlanych jednocześnie, ponieważ karty muszą zajmować ograniczoną ilość miejsca na ekranie. Staraj się też unikać niepotrzebnej złożoności kart.