Dodatek Google Workspace oparty na kartach wyświetla się jako panel na pasku bocznym (lub na urządzeniu mobilnym jako kolejne okno aktywności, do którego można przejść z menu). Dodatek
ma górny pasek narzędzi, który identyfikuje
dodatek i wyświetla kartę – zasadniczo „stronę”
interfejsu dodatku. Google Apps Script reprezentuje
karty w kodzie projektu za pomocą Card
obiektów.
Budowa karty
Karta to grupa zaprojektowanych przez Ciebie elementów interfejsu. Karta składa się z tych sekcji:
- Nagłówek karty. Identyfikuje karty. Zawiera tekst tytułu, a opcjonalnie także podtytuł i ikonę.
Co najmniej 1 sekcja karty. Są to podziały obszaru interfejsu karty. Sekcja może mieć nagłówek tekstowy. Sekcje karty są oddzielone od siebie poziomą linią. Jeśli sekcja karty jest szczególnie duża, jest automatycznie renderowana jako sekcja zwijana, którą użytkownicy mogą rozwijać i zwijać w razie potrzeby. Karta może mieć maksymalnie 100 sekcji, ale dla lepszej wydajności powinna mieć ich tylko kilka.
Każda sekcja karty zawiera co najmniej 1 widżet interfejsu . Widżety dostarczają użytkownikowi informacji lub elementów sterujących. Karty i sekcje kart to widżety strukturalne, więc nie można ich dodawać do sekcji karty. Sekcja karty może zawierać maksymalnie 100 widżetów i powinna być jak najbardziej zwięzła, aby zapewnić najlepszą wydajność.
Karty należy projektować pod kątem konkretnych działań użytkownika lub zbiorów danych. Na przykład dodatek Google Workspace, który wyświetla dane pobrane z Arkuszy Google, może mieć oddzielną 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 albo skonfigurować te karty jako listę do podstawowej nawigacji, albo skonfigurować bardziej złożone metody nawigacji , aby kontrolować sposób przechodzenia użytkownika między kartami. Więcej informacji znajdziesz w artykule Podstawowa nawigacja z użyciem wielu kart.
Jeśli dodatek korzysta z podstawowej nawigacji, po jego pierwszym otwarciu aplikacja Google Workspace, którą rozszerza, tworzy listę nagłówków kart i wyświetla ją użytkownikowi. Kliknięcie nagłówka karty powoduje otwarcie tej karty. Dostępna jest też strzałka wstecz, która umożliwia powrót do listy nagłówków kart. Nie musisz kodować funkcji nagłówka i strzałki wstecz – jest to robione automatycznie, gdy definiujesz 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 karty.