Ein kartenbasiertes Add-on wird als Bereich in der Seitenleiste angezeigt (auf Mobilgeräten als weiteres Aktivitätsfenster, das über das Menü aufgerufen wird). Das Add-on hat oben eine Symbolleiste, die das Add-on identifiziert, und eine Karte – im Grunde eine „Seite“ der Benutzeroberfläche des Add-ons. In Apps Script werden Karten im Projektcode mit Card-Objekten dargestellt.
Kartenaufbau
Eine Karte ist eine Gruppe von UI-Elementen, die Sie entwerfen. Eine Karte besteht aus den folgenden Abschnitten:
- Kartenheader So werden die Karten identifiziert. Sie enthält einen Titeltext und kann optional einen Untertitel und ein Symbol haben.
Einen oder mehrere Kartenabschnitte Dies sind Unterteilungen des UI-Bereichs der Karte. Ein Abschnitt kann optional eine Textabschnittsüberschrift haben. Kartenabschnitte sind auf der Karte durch eine horizontale Linie voneinander getrennt. Wenn ein Kartenbereich besonders groß ist, wird er automatisch als minimierbarer Bereich gerendert, den Nutzer nach Bedarf maximieren oder minimieren können. Eine Karte kann maximal 100 Kartenabschnitte haben und sollte nur wenige enthalten, um eine bessere Leistung zu erzielen.
Jeder Kartenbereich enthält ein oder mehrere UI-Widgets. Widgets stellen Nutzern Informationen oder interaktive Steuerelemente zur Verfügung. Karten und Kartenbereiche sind strukturelle Widgets und können daher keinem Kartenbereich hinzugefügt werden. Ein Kartenbereich darf nicht mehr als 100 Widgets enthalten und sollte für eine optimale Leistung so einfach wie möglich sein.
Sie sollten Karten auf bestimmte Nutzeraktivitäten oder Datensätze zuschneiden. 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
Add-ons bestehen in der Regel aus mehreren Karten. Sie können diese Karten entweder als einfache Liste für die einfache Navigation mit mehreren Karten oder als komplexere Navigationsmethoden konfigurieren, um zu steuern, wie sich Nutzer zwischen den Karten bewegen.
Wenn das Add-on eine einfache Navigation verwendet, wird beim ersten Öffnen des Add-ons eine Liste der Kartenüberschriften erstellt und dem Nutzer angezeigt. Wenn Sie auf die Kartenüberschrift klicken, wird die Karte geöffnet. Über einen Zurückpfeil können Sie auch zur Liste der Kartenheader zurückkehren. Sie müssen die Funktion für den Header und den Zurückpfeil nicht programmieren. Das geschieht automatisch, wenn Sie die Karten in Ihrem Add-on definieren.
Beim Entwerfen von Add-ons sollten Sie die Anzahl der Karten begrenzen, die gleichzeitig angezeigt werden, da die Karten einen begrenzten Bildschirmbereich teilen müssen. Außerdem sollten Sie unnötige Komplexität bei Karten vermeiden.