Kartenbasierte Oberflächen

Beispiel für eine Add-on-Karte

Google Workspace-Add-ons enthalten Informationen und Nutzersteuerelemente in der Seitenleiste der Benutzeroberfläche der Hostanwendung. Ein Add-on besteht aus einer Hauptsymbolleiste zur Identifizierung sowie einer oder mehreren Karten.

Jede Karte stellt eine bestimmte „Seite“ der Benutzeroberfläche Ihres Add-ons dar. Um zu einer neuen Karte zu wechseln, müssen Sie diese Karte in der Regel nur erstellen und in einen internen Kartenstapel einfügen. Sie können Navigationsabläufe zwischen Karten definieren, um die Interaktion zu verbessern.

Karten können kontextunabhängig oder kontextbezogen sein. Kontextkarten werden dem Nutzer angezeigt, wenn sich die Hostanwendung in einem bestimmten Kontext befindet. Beispielsweise beim Öffnen einer Gmail-Nachricht oder eines Kalendertermins. Nicht kontextbezogene Karten (z. B. Startseiten) werden dem Nutzer außerhalb eines bestimmten Kontexts des Hosts angezeigt. Beispielsweise, wenn der Nutzer seinen Gmail-Posteingang, seinen Hauptordner in Google Drive oder Google Kalender aufruft.

In Apps Script erstellte Google Workspace-Add-ons verwenden den Kartendienst, um Benutzeroberflächen aus Karten zu erstellen. Add-ons, die in anderen Sprachen erstellt wurden, müssen korrekt formatierte JSON-Dateien zurückgeben, damit die Benutzeroberfläche Karten anzeigt.

Jede Karte besteht aus einer Überschrift und einem oder mehreren Kartenabschnitten. Jeder Abschnitt besteht aus einer Reihe von Widgets. Widgets zeigen dem Nutzer Informationen an oder bieten Interaktionssteuerungen wie Schaltflächen.

Kartenbasierte Oberflächen bieten folgende Vorteile:

  • Für die Erstellung von cardbasierten Benutzeroberflächen sind keine HTML- oder CSS-Kenntnisse erforderlich.
  • Karten und Widgets werden automatisch so gestaltet, dass sie gut zu den Google Workspace-Anwendungen passen, die sie ergänzen.

  • Kartenbasierte Oberflächen funktionieren sowohl auf Computern als auch auf Mobilgeräten. Sie müssen die Oberfläche jedoch nur einmal definieren.

Kartenbasierte Benutzeroberflächen erstellen

Wenn Sie cardbasierte Add-ons erstellen, ist es wichtig, bestimmte Konzepte und Designmuster zu verstehen. In den folgenden Anleitungen finden Sie die Informationen, die Sie zum Erstellen effektiver kartenbasierter Add-ons benötigen:

Berücksichtigen Sie diese Seiten beim Erstellen von Karten und beim Implementieren des UI-Verhaltens. Die folgenden zusätzlichen Beispiele können Ihnen bei der Implementierung Ihres Add-ons als Referenz dienen: