Interfejsy oparte na kartach

Dodatki do Google Workspace są oparte na kartach. Dodatki do edytorów są oparte na HTML-u.

Dodatki wyświetlają informacje i elementy sterujące w panelu bocznym interfejsu aplikacji hosta. Dodatek do Google Workspace składa się z głównego paska narzędzi identyfikujących oraz co najmniej jednej karty.

Każda karta reprezentuje konkretną „stronę” interfejsu dodatku. Przejście do nowej karty zwykle polega na utworzeniu tej karty i przesłaniu jej do wewnętrznego stosu kart. Możesz zdefiniować przepływy nawigacji między kartami, aby zapewnić użytkownikom bogate interakcje.

Karty mogą być niekontekstowe lub kontekstowe. Karty kontekstowe są wyświetlane użytkownikowi, gdy aplikacja hostująca znajduje się w określonym kontekście, np. podczas otwierania wiadomości w Gmailu lub wydarzenia w Kalendarzu Google. Karty niezwiązane z kontekstem (np. strony główne) są wyświetlane użytkownikowi poza konkretnym kontekstem hosta, np. gdy użytkownik przegląda skrzynkę odbiorczą Gmaila, główny folder Dysku Google lub Kalendarz.

Dodatki do Google Workspace utworzone w Google Apps Script korzystają z usługi kart, aby tworzyć interfejsy użytkownika z kart. Dodatki utworzone w innych językach muszą zwracać prawidłowo sformatowany plik JSON, aby interfejs renderował się 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. Widżety wyświetlają informacje dla użytkownika lub udostępniają elementy sterujące, takie jak przyciski.

Interfejsy oparte na kartach mają te zalety:

• Do tworzenia interfejsów opartych na kartach nie jest wymagana znajomość 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 wystarczy zdefiniować je tylko raz.

Gmail to jedyna aplikacja hosta, którą można rozszerzyć za pomocą dodatków do Google Workspace na urządzeniach mobilnych.

Tworzenie interfejsów opartych na kartach

Podczas tworzenia dodatków opartych na kartach warto poznać pewne koncepcje i wzorce projektowe. W tych przewodnikach znajdziesz informacje potrzebne do tworzenia skutecznych dodatków opartych na kartach:

• Karty
• Strony główne
• Widżety
• Działania
• Obiekty zdarzeń
• Tworzenie kart
• Tworzenie kart interaktywnych
• Przechodzenie między kartami
• Korzystanie z czynności uniwersalnych
• Dodawanie autouzupełniania do pól tekstowych
• Uzyskiwanie dostępu do ustawień regionalnych i stref czasowych użytkowników
• Łączenie z usługami innych firm
• Style guide
• Sprawdzone metody

Podczas tworzenia kart i wdrażania zachowania interfejsu odwołuj się do tych stron. Podczas wdrażania dodatku mogą Ci się przydać te dodatkowe przykłady:

• Szybkie wprowadzenie do dodatku „Cats” do Google Workspace

  Ten przykład dodatku pokazuje interfejs dodatku z wieloma stronami i stronami głównymi.

• Dodatek do Google Workspace: „Translate”

  Ten przykładowy dodatek pokazuje dodatek, który umożliwia użytkownikom tłumaczenie tekstu w Dokumentach, Arkuszach i Prezentacjach.

• Dodatek do Google Workspace: „Lista zespołów”

  Ten przykład dodatku 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, edytujących pliki na Dysku lub uczestników wydarzenia w Kalendarzu. Tego dodatku możesz używać tylko w domenie, ponieważ do pobierania informacji o użytkownikach korzysta on z interfejsu Directory API.