Dodatki Google Workspace wyświetlają informacje i opcje użytkownika na pasku bocznym interfejsu aplikacji hosta. Dodatek składa się z głównego paska narzędzi z identyfikatorem oraz co najmniej 1 karty.
Każda karta reprezentuje określoną „stronę” interfejsu dodatku, a przejście do nowej karty polega zwykle na utworzeniu tej karty i przesłaniu jej do wewnętrznego stosu kart. Aby zapewnić użytkownikom bogate wrażenia, możesz zdefiniować przepływy nawigacji między kartami.
Karty mogą być niekontekstualne lub kontekstualne. Karty kontekstowe są wyświetlane użytkownikowi, gdy aplikacja hostująca znajduje się w określonym kontekście. na przykład podczas otwierania wiadomości w Gmailu lub wydarzenia w Kalendarzu. Karty bez kontekstu (np. strony główne) są wyświetlane użytkownikowi poza konkretnym kontekstem hosta. Na przykład gdy użytkownik wyświetla skrzynkę odbiorczą Gmaila, główny folder na Dysku lub Kalendarz.
Dodatki Google Workspace utworzone w Apps Script korzystają z usługi kart do tworzenia interfejsów użytkownika na podstawie kart. Wtyczki utworzone w innych językach muszą zwracać prawidłowo sformatowany kod JSON, aby interfejs mógł je renderować jako karty.
Każda karta składa się z nagłówka i co najmniej 1 sekcji. Każda sekcja składa się z zestawu widżetów. Widgety wyświetlają informacje użytkownikowi lub udostępniają elementy sterujące, takie jak przyciski.
Interfejsy oparte na kartach mają te zalety:
- Aby tworzyć interfejsy oparte na kartach, nie trzeba znać HTML ani CSS.
- Karty i widżety są automatycznie stylizowane tak, aby dobrze współpracowały z aplikacjami Google Workspace, które rozszerzają.
Interfejsy oparte na kartach działają zarówno na komputerach, jak i na urządzeniach mobilnych, ale musisz zdefiniować interfejs tylko raz.
Tworzenie interfejsów opartych na kartach
Podczas tworzenia dodatków opartych na kartach ważne jest zrozumienie pewnych koncepcji i wzorców projektowania. W tych przewodnikach znajdziesz informacje potrzebne do tworzenia skutecznych dodatków na kartach:
- Karty
- Strony główne
- Widżety
- Działania
- Obiekty zdarzenia
- Tworzenie kart
- Tworzenie kart interaktywnych
- Przechodzenie między kartami
- Korzystanie z działań uniwersalnych
- Dodawanie autouzupełniania do pól tekstowych
- Dostęp do ustawień regionalnych i stref czasowych użytkowników
- Łączenie z usługami innych firm
- Przewodnik dotyczący stylu
- Sprawdzone metody
Odwołuj się do tych stron podczas tworzenia kart i wdrażania zachowania interfejsu użytkownika. Podczas implementowania dodatku możesz też skorzystać z tych dodatkowych przykładów:
Krótki przewodnik po dodatku „Cats” do Google Workspace
Ten przykładowy dodatek zawiera prosty interfejs dodatku Google Workspace z wieloma stronami i stronami początkowymi.
Dodatek do Google Workspace: „Translate”
Ten przykładowy dodatek do Google Workspace umożliwia użytkownikom tłumaczenie tekstu w Dokumentach, Arkuszach i Prezentacjach.
Dodatek do Google Workspace: „Lista zespołów”
Ten przykładowy dodatek pokazuje bardziej złożony przykład dodatku Google Workspace, który wyświetla informacje o użytkownikach dotyczące odbiorców wiadomości w Gmailu, edytorów plików na Dysku lub uczestników wydarzeń w Kalendarzu. Z tego dodatku możesz korzystać tylko w domenie, ponieważ do pobierania informacji o użytkownikach używa interfejsu Directory API.