Infokarten

Ein kartenbasiertes Google Workspace-Add-on wird als Bereich in der Seitenleiste oder auf Mobilgeräten als weiteres Aktivitätsfenster angezeigt, das über das Menü aufgerufen werden kann. Das Add-on hat eine obere Symbolleiste, in der das Add-on identifiziert wird und eine Karte angezeigt wird. Eine Karte ist im Grunde eine "Seite" der Benutzeroberfläche des Add-ons. In Google Apps Script werden Karten im Projektcode mit Card Objekten dargestellt.

Anatomie einer Karte

Beispiel für eine Add-on-Karte mit Kontaktdaten

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

  • Kartenkopfzeile Diese identifiziert die Karten. Sie enthält einen Titel und optional einen Untertitel und ein Symbol.

  • Ein oder mehrere Kartenabschnitte Dies sind Unterbereiche des UI-Bereichs der Karte. Ein Abschnitt kann eine Textabschnittsüberschrift haben. Kartenabschnitte werden auf der Karte durch eine horizontale Linie voneinander getrennt. Wenn ein Kartenabschnitt besonders groß ist, wird er automatisch als minimierbarer Abschnitt gerendert, den Nutzer nach Bedarf maximieren oder minimieren können. Eine Karte kann maximal 100 Kartenabschnitte haben, und für eine bessere Leistung sollten es nur wenige sein.

  • Jeder Kartenabschnitt enthält ein oder mehrere UI Widgets. Widgets liefern dem Nutzer Informationen oder interaktive Steuerelemente. Karten und Kartenabschnitte sind strukturelle Widgets. Sie können sie daher nicht zu einem Kartenabschnitt hinzufügen. Ein Kartenabschnitt kann maximal 100 Widgets haben. Für eine optimale Leistung sollte er so kurz wie möglich sein.

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

Mehrere Karten verwenden

Beispiel für eine Add‑on-Karte mit einer einfachen Benutzeroberfläche

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

Wenn das Add-on die grundlegende Navigation verwendet, erstellt die Google Workspace-Anwendung, die das Add-on erweitert, beim ersten Öffnen des Add-ons eine Liste der Kartenkopfzeilen und präsentiert sie dem Nutzer. Durch Klicken auf die Kartenkopfzeile wird die entsprechende Karte geöffnet. Außerdem wird ein Zurück-Pfeil angezeigt, mit dem Sie zur Liste der Kartenkopfzeilen zurückkehren können. Sie müssen die Funktionalität für die Kopfzeile und den Zurück-Pfeil nicht codieren. Das erfolgt 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 sich die Karten einen begrenzten Bildschirmbereich teilen müssen. Außerdem sollten Sie unnötige Komplexität in Karten vermeiden.

Aus Leistungsgründen können Sie einer Karte nicht mehr als 100 Widgets oder 100 Kartenabschnitte hinzufügen.