Karten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Ein kartenbasiertes Add-on wird als Bereich in der Seitenleiste angezeigt (oder auf Mobilgeräten als weiteres Aktivitätsfenster, das über das Menü geöffnet wird). Das Add-on hat eine obere Symbolleiste, die das Add-on identifizierbar macht und eine Karte anzeigt – im Wesentlichen eine Seite der Add-ons. Apps Script stellt Karten im Projektcode mithilfe von Card-Objekten dar.

Anatomie der Karte

Beispiel für eine Add-on-Karte

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

  • Kartenkopfzeile Dadurch werden die Karten identifiziert. Er hat einen Titeltext und kann optional einen Untertitel und ein Symbol enthalten.
  • Ein oder mehrere Kartenbereiche. Das sind die Untergruppen des UI-Bereichs der Karte. Ein Abschnitt kann optional eine Kopfzeile haben. Kartenabschnitte auf der Karte sind durch einen horizontalen Bereich voneinander getrennt. Wenn ein Kartenbereich besonders groß ist, wird er automatisch als minimierbarer Bereich dargestellt, den Nutzer nach Bedarf maximieren oder minimieren können. Eine Karte darf maximal 100 Kartenbereiche enthalten und nur wenige für eine bessere Leistung.

  • Jeder Kartenbereich enthält ein oder mehrere UI-Widgets. Widgets bieten dem Nutzer Informationen oder interaktive Steuerelemente. Karten und Kartenabschnitte sind strukturelle Widgets. Sie können sie daher keinem Kartenabschnitt hinzufügen. Ein Kartenabschnitt kann maximal 100 Widgets enthalten und sollte so einfach wie möglich sein, um eine optimale Leistung zu erzielen.

Sie sollten Karten für bestimmte Nutzeraktivitäten oder Datensätze erstellen. Ein Add-on in Google Workspace, 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 eine Add-on-Karte

Add-ons bestehen normalerweise 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 und so steuern, wie der Nutzer zwischen den Karten wechselt.

Wenn das Add-on eine einfache Navigation verwendet, wird beim ersten Öffnen des Google Workspace-Add-ons eine Liste der Kartenheader erstellt und dem Nutzer präsentiert. Wenn Sie auf den Kartenheader klicken, wird die Karte geöffnet. Über einen Zurückpfeil gelangst du zurück zur Liste der Kartenheader. Sie müssen den Header und den Zurückpfeil nicht codieren – dies erfolgt automatisch, wenn Sie die Karten in Ihrem Add-on definieren.

Wenn du Add-ons entwickelst, solltest du die Anzahl der angezeigten Karten auf einmal begrenzen, da die Karten nur einen begrenzten Bildschirmbereich haben müssen. Außerdem sollten Sie Karten nicht unnötig komplex machen.