Interfejsy oparte na kartach

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

Przykład interfejsu karty dodatku do Google Workspace.

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 identyfikacyjnych wraz z co najmniej 1 kartą.

Każda karta reprezentuje określoną „stronę” interfejsu dodatku. Przejście do nowej karty zwykle polega na jej utworzeniu i umieszczeniu na wewnętrznym stosie kart. Możesz zdefiniować przepływy nawigacji między kartami, aby zapewnić bogate interakcje.

Karty mogą być niekontekstowe lub kontekstowe. Karty kontekstowe są wyświetlane użytkownikowi, gdy aplikacja hosta znajduje się w określonym kontekście, np. podczas otwierania wiadomości w Gmailu lub wydarzenia w Kalendarzu Google. Karty niekontekstowe (np. strony główne) są wyświetlane użytkownikowi poza określonym 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 używają usługi Card do tworzenia interfejsów użytkownika z kart. Dodatki utworzone w innych językach muszą zwracać prawidłowo sformatowany kod JSON, aby interfejs był renderowany 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 użytkownikowi 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ść języków HTML ani CSS.
  • Karty i widżety są automatycznie stylizowane, aby dobrze współpracować 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 ważne jest, aby zrozumieć pewne koncepcje i wzorce projektowe. W tych przewodnikach znajdziesz informacje potrzebne do tworzenia skutecznych dodatków opartych na kartach:

Podczas tworzenia kart i implementowania zachowania interfejsu użytkownika korzystaj z tych stron. Podczas implementowania dodatku mogą Ci się też przydać te dodatkowe przykłady: