Karten

Ein kartenbasiertes Add-on wird als Bereich in der Seitenleiste angezeigt (oder auf Mobilgeräten als ein anderes Aktivitätsfenster, das über das Menü aufgerufen wird). Das Add-on hat eine Symbolleiste am oberen Rand, auf der das Add-on identifiziert wird. Außerdem wird eine Karte angezeigt, die im Wesentlichen eine "Seite" der UI des Add-ons darstellt. Apps Script stellt Karten im Projektcode mithilfe von Card-Objekten dar.

Aufbau von Karten

Beispiel für Add-on-Karte

Eine Karte ist eine Gruppe von UI-Elementen, die Sie entwerfen. Eine Karte besteht aus den folgenden Abschnitten:

  • Eine Kartenüberschrift. Damit werden die Karten identifiziert. Sie enthält Titeltext und optional Untertitel und Symbol.
  • Ein oder mehrere Kartenabschnitte: Das sind Untergruppen des UI-Bereichs der Karte. Ein Abschnitt kann optional eine Abschnittsüberschrift in Textform haben. Die Kartenabschnitte sind auf der Karte durch eine horizontale Linie voneinander getrennt. Wenn ein Kartenabschnitt besonders groß ist, wird er automatisch als minimierbarer Bereich gerendert, den Nutzer nach Bedarf maximieren oder minimieren können. Eine Karte kann nicht mehr als 100 Kartenbereiche haben und sollte nur wenige enthalten, um eine bessere Leistung zu erzielen.

  • Jeder Kartenabschnitt enthält ein oder mehrere UI-Widgets. Widgets bieten den Nutzenden Informationen oder interaktive Steuerelemente. Karten- und Kartenabschnitte sind strukturelle Widgets und können daher nicht zu einem Kartenabschnitt hinzugefügt werden. Ein Kartenbereich darf maximal 100 Widgets haben und sollte so einfach wie möglich sein, um eine optimale Leistung zu erzielen.

Sie sollten Karten zu bestimmten Nutzeraktivitäten oder Datensätzen entwerfen. Ein Google Workspace-Add-on, das Daten aus Google Tabellen anzeigt, kann beispielsweise eine separate Karte für jedes Tabellenblatt haben, aus dem Daten abgerufen werden.

Mehrere Karten verwenden

Beispiel für Add-on-Karte

Add-ons bestehen in der Regel aus mehreren Karten. Sie können diese Karten entweder als einfache Liste für die grundlegende Navigation mit mehreren Karten konfigurieren oder komplexere Navigationsmethoden konfigurieren, um zu steuern, wie der Nutzer zwischen den Karten wechselt.

Wenn das Add-on die einfache Navigation verwendet und das Add-on zum ersten Mal in der Google Workspace-Anwendung geöffnet wird, wird eine Liste der Kartenheader erstellt und dem Nutzer angezeigt. Durch Klicken auf die Kartenüberschrift wird diese Karte geöffnet. Außerdem gibt es einen Zurückpfeil, um zur Liste der Kartenheader zurückzukehren. Sie müssen die Funktionen für den Header und den Zurückpfeil nicht codieren. Dies erfolgt automatisch, wenn Sie die Karten in Ihrem Add-on definieren.

Beim Entwerfen von Add-ons empfiehlt es sich, die Anzahl der Karten zu begrenzen, die gleichzeitig angezeigt werden, da Karten einen begrenzten Bildschirmbereich teilen müssen. Vermeiden Sie außerdem unnötige Komplexität der Karten.