Dodatek oparty na karcie wyświetla się jako panel na pasku bocznym (lub na urządzeniu mobilnym jako kolejne okno aktywności dostępne w menu). Dodatek ma górny pasek narzędzi, który go identyfikuje i wyświetla kartę – czyli „stronę” interfejsu użytkownika dodatku. Apps Script reprezentuje karty w kodzie projektu za pomocą obiektów Card.
Budowa karty
Karta to grupa projektowanych przez Ciebie elementów interfejsu. Karta składa się z tych sekcji:
- Nagłówek karty. To identyfikuje karty. Zawiera tekst tytułu i opcjonalnie podtytuł oraz ikonę.
Co najmniej 1 sekcję karty. Są to podziały obszaru interfejsu karty. Sekcja może mieć opcjonalny nagłówek tekstowy. Sekcje karty są od siebie oddzielone poziomą linią. Jeśli sekcja karty jest szczególnie duża, jest automatycznie renderowana jako sekcja zwijana, którą użytkownicy mogą rozwijać lub zwijać w miarę potrzeby. Karta może zawierać maksymalnie 100 sekcji i dla lepszej skuteczności powinna zawierać tylko kilka sekcji.
Każda sekcja karty zawiera co najmniej 1 widżet interfejsu użytkownika. Widgety dostarczają użytkownikowi informacji lub elementów sterujących. Karty i sekcje kart są widżetami strukturalnymi, więc nie można ich dodawać do sekcji kart. Sekcja karty może zawierać maksymalnie 100 widżetów i powinna być jak najprostsza, aby zapewnić największą skuteczność.
Projektując karty, należy uwzględnić w nich konkretne działania użytkowników lub zbiory danych. Na przykład dodatek Google Workspace wyświetlający dane pochodzące 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 prostą listę w celu podstawowej nawigacji z wieloma kartami lub skonfigurować bardziej złożone metody nawigacji, aby kontrolować sposób poruszania się użytkownika między kartami.
Jeśli dodatek korzysta z podstawowej nawigacji, po jego pierwszym otwarciu aplikacja Google Workspace, którą rozszerza, tworzy listę nagłówków kart i przedstawia ją użytkownikowi. Kliknięcie nagłówka karty powoduje jej otwarcie. Dostępna jest też strzałka wstecz, która umożliwia powrót do listy nagłówków kart. Nie musisz kodować nagłówka ani strzałki wstecz – robi się to automatycznie podczas definiowania kart w dodatku.
Podczas projektowania rozszerzeń najlepiej ograniczyć liczbę wyświetlanych jednocześnie kart, ponieważ muszą one mieścić się w ograniczonej przestrzeni ekranu. Warto też unikać niepotrzebnie złożonych kart.