Dodatek do Google Workspace oparty na kartach wyświetla się jako panel na pasku bocznym (lub na urządzeniach mobilnych jako kolejne okno aktywności dostępne w menu). Dodatek ma górny pasek narzędzi, który identyfikuje dodatek i wyświetla kartę – w zasadzie „stronę” interfejsu dodatku. Google Apps Script reprezentuje karty w kodzie projektu za pomocą obiektów Card.
Budowa karty
Karta to grupa zaprojektowanych przez Ciebie elementów interfejsu. Karta składa się z tych sekcji:
- Nagłówek karty. Pozwala to zidentyfikować karty. Zawiera tekst tytułu i opcjonalnie podtytuł oraz ikonę.
Co najmniej 1 sekcja karty. Są to podziały obszaru interfejsu karty. Sekcja może mieć nagłówek tekstowy. Sekcje karty są od siebie oddzielone linią poziomą. Jeśli sekcja karty jest szczególnie duża, jest automatycznie renderowana jako zwijana sekcja, którą użytkownicy mogą rozwijać i zwijać w zależności od potrzeb. Karta może zawierać maksymalnie 100 sekcji, ale dla lepszej skuteczności powinna mieć ich tylko kilka.
Każda sekcja karty zawiera co najmniej 1 widżet interfejsu. Widżety dostarczają użytkownikowi informacji lub interaktywnych elementów sterujących. Karty i sekcje kart to widżety strukturalne, więc nie możesz ich dodawać do sekcji kart. Sekcja karty może zawierać maksymalnie 100 widżetów i powinna być jak najkrótsza, aby zapewnić najlepszą wydajność.
Karty powinny być zaprojektowane pod kątem konkretnych działań użytkowników lub zbiorów danych. Na przykład dodatek do Google Workspace, który wyświetla dane pobrane z Arkuszy Google, może mieć osobną kartę dla każdego arkusza, z którego pobiera dane.
Korzystanie z wielu kart
Dodatki zwykle składają się z więcej niż 1 karty. Możesz skonfigurować te karty jako listę do podstawowej nawigacji lub skonfigurować bardziej złożone metody nawigacji, aby kontrolować sposób przechodzenia użytkownika między kartami. Szczegółowe informacje znajdziesz w artykule Podstawowa nawigacja z użyciem wielu kart.
Jeśli dodatek korzysta z podstawowej nawigacji, po pierwszym otwarciu dodatku aplikacja Google Workspace, którą rozszerza, tworzy listę nagłówków kart i wyświetla ją użytkownikowi. Kliknięcie nagłówka karty spowoduje jej otwarcie. Dostępna jest też strzałka wstecz, która umożliwia powrót do listy nagłówków kart. Nie musisz programować funkcji nagłówka i strzałki wstecz – są one dodawane automatycznie, gdy zdefiniujesz karty w dodatku.
Podczas projektowania dodatków najlepiej ograniczyć liczbę kart wyświetlanych jednocześnie, ponieważ karty muszą dzielić ograniczoną ilość miejsca na ekranie. Warto też unikać niepotrzebnej złożoności kart.
Ze względu na wydajność nie możesz dodać do karty więcej niż 100 widżetów ani 100 sekcji kart.