Dodatki do Google Workspace wyświetlają informacje i opcje użytkownika na pasku bocznym w interfejsie aplikacji hosta. Dodatek składa się z głównego paska narzędzi umożliwiającego identyfikację i co najmniej 1 karty.
Każda karta reprezentuje konkretną „stronę” interfejsu dodatku, a przejście do nowej karty zazwyczaj polega na utworzeniu karty i przekazaniu jej na wewnętrzny stos kart. Możesz zdefiniować przepływy nawigacji między kartami, aby zwiększyć możliwości interakcji.
Karty mogą być niekontekstowe lub kontekstowe. Karty kontekstowe są pokazywane użytkownikowi, gdy aplikacja hostująca działa w określonym kontekście. na przykład podczas otwierania wiadomości w Gmailu lub wydarzenia w Kalendarzu. Karty niekontekstowe (takie jak strony główne) są wyświetlane użytkownikowi poza określonym kontekstem hosta. Dzieje się tak na przykład wtedy, gdy użytkownik przegląda swoją skrzynkę odbiorczą w Gmailu, główny folder na Dysku lub Kalendarz.
Dodatki do Google Workspace wbudowane w Apps Script wykorzystują usługę karty do tworzenia interfejsów użytkownika na podstawie kart. Dodatki utworzone w innych językach muszą zwracać poprawnie sformatowany plik JSON, by interfejs był renderowany jako karty.
Każda karta składa się z nagłówka i co najmniej 1 sekcji karty. Każda sekcja składa się z zestawu widżetów. Widżety wyświetlają informacje użytkownikom lub zapewniają elementy sterujące interakcjami, np. przyciski.
Interfejs oparty na kartach ma następujące zalety:
- Aby tworzyć interfejsy oparte na kartach, nie musisz znać się na języku HTML ani CSS.
- Karty i widżety są automatycznie dostosowywane tak, aby dobrze działały z rozszerzanymi aplikacjami Google Workspace.
Interfejsy kart działają zarówno na komputerach, jak i urządzeniach mobilnych, ale wystarczy zdefiniować interfejs tylko raz.
Tworzenie interfejsów opartych na kartach
Przy tworzeniu dodatków opartych na kartach ważne jest, by rozumieć określone koncepcje i wzorce projektowe. Te przewodniki zawierają informacje, które pomogą Ci tworzyć skuteczne dodatki oparte na kartach:
- Karty
- Strony główne
- Widżety
- Działania
- Obiekty zdarzeń
- Tworzenie kart
- Tworzenie interaktywnych kart
- Przechodzenie między kartami
- Używanie działań uniwersalnych
- Dodawanie autouzupełniania do wprowadzania tekstu
- Dostęp do ustawień regionalnych i stref czasowych użytkownika
- Łączenie z usługami innych firm
- Przewodnik stylistyczny
- Sprawdzone metody
Odwołuj się do tych stron podczas tworzenia kart i implementowania interfejsu. Podczas wdrażania dodatku mogą Ci się przydać te dodatkowe przykłady:
Krótkie wprowadzenie do dodatku Google Workspace „Cats”
Ten przykładowy dodatek pokazuje prosty interfejs dodatku do Google Workspace z wieloma stronami i stronami głównymi.
Dodatek do Google Workspace: „Translate”
Ten przykładowy dodatek pokazuje dodatek do Google Workspace, który umożliwia użytkownikom tłumaczenie tekstu z Dokumentów, Arkuszy i Prezentacji.
Dodatek do Google Workspace: „Lista zespołów”
Ten przykładowy dodatek pokazuje bardziej złożony przykład dodatku do Google Workspace, który zawiera informacje o odbiorcach wiadomości z Gmaila, edytorach plików na Dysku i uczestnikach wydarzeń w Kalendarzu. Tego dodatku możesz używać tylko w domenie, ponieważ pobiera on informacje o użytkownikach za pomocą interfejsu Directory API.