Class Columns

Spalten

Im Columns-Widget werden bis zu zwei Spalten auf einer Karte oder in einem Dialogfeld angezeigt. Sie können jeder Column Widgets hinzufügen. Die Widgets werden in der angegebenen Reihenfolge angezeigt. Ein Beispiel für Google Chat-Apps finden Sie unter Spalten.

Die Höhe jeder Spalte wird durch die höhere Spalte bestimmt. Wenn die erste Spalte beispielsweise höher als die zweite ist, haben beide Spalten die Höhe der ersten Spalte. Da jede Spalte eine unterschiedliche Anzahl von Widgets enthalten kann, lassen sich keine Zeilen definieren oder Widgets zwischen den Spalten ausrichten.

Spalten werden nebeneinander angezeigt. Mit dem Feld HorizontalSizeStyle können Sie die Breite der einzelnen Spalten anpassen. Wenn die Bildschirmbreite des Nutzers zu gering ist, wird die zweite Spalte unter der ersten umgebrochen:

  • Im Web wird die zweite Spalte umgebrochen, wenn die Bildschirmbreite kleiner oder gleich 480 Pixel ist.
  • Auf iOS-Geräten wird die zweite Spalte umgebrochen, wenn die Bildschirmbreite kleiner oder gleich 300 pt ist.
  • Auf Android-Geräten wird die zweite Spalte umgebrochen, wenn die Bildschirmbreite kleiner oder gleich 320 dp ist.

Für Google Chat-Apps und Google Workspace-Add‑ons verfügbar. Die Add-on-Benutzeroberflächen, die Spalten unterstützen, sind:

  • Das Dialogfeld, das angezeigt wird, wenn Nutzer das Add-on über einen E-Mail-Entwurf öffnen.
  • Das Dialogfeld, das angezeigt wird, wenn Nutzer das Add-on über das Menü Anhang hinzufügen in einem Google Kalender-Termin öffnen. 
    // Build a column that is aligned in the center and fills the space:
const column =
    CardService.newColumn()
        .setHorizontalSizeStyle(
            CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE)
        .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER)
        .setVerticalAlignment(CardService.VerticalAlignment.CENTER);
const columns = CardService.newColumns().addColumn(column).setWrapStyle(
    CardService.WrapStyle.WRAP);

Methoden

MethodeRückgabetypKurzbeschreibung
addColumn(column)ColumnsFügt dem Widget „Spalten“ ein Column hinzu.
addEventAction(eventAction)WidgetFügt die Ereignisaktion hinzu, die für das Widget ausgeführt werden kann.
setId(id)WidgetLegt die eindeutige ID fest, die zum Identifizieren des zu ändernden Widgets verwendet wird.
setVisibility(visibility)WidgetLegt die Sichtbarkeit des Widgets fest.
setWrapStyle(wrapStyle)ColumnsLegt den Umbruchstil der Spalten fest und steuert, wie die Spalte basierend auf der Bildschirmbreite angepasst wird.

Detaillierte Dokumentation

addColumn(column)

Fügt dem Widget „Spalten“ ein Column hinzu. Spalten werden in der Reihenfolge angezeigt, in der sie hinzugefügt werden. Sie können bis zu zwei Spalten hinzufügen. 

const columns = CardService.newColumns().addColumn(CardService.newColumn());

Parameter

NameTypBeschreibung
columnColumnEine untergeordnete Spalte, die dem Widget „Spalten“ hinzugefügt werden soll.

Rückflug

Columns: Dieses Objekt zur Verkettung.

addEventAction(eventAction)

Fügt die Ereignisaktion hinzu, die für das Widget ausgeführt werden kann.

Parameter

NameTypBeschreibung
eventActionEventActionDie hinzuzufügende EventAction.

Rückflug

Widget – Das Objekt für die Verkettung.

setId(id)

Legt die eindeutige ID fest, die zum Identifizieren des zu ändernden Widgets verwendet wird. Die Mutation von Widgets wird nur in Add-ons unterstützt.

Parameter

NameTypBeschreibung
idStringDie ID des Widgets mit einem Limit von 64 Zeichen und im Format `[a-zA-Z0-9-]+`.

Rückflug

Widget: Dieses Objekt zur Verkettung.

setVisibility(visibility)

Legt die Sichtbarkeit des Widgets fest. Der Standardwert ist „VISIBLE“.

Parameter

NameTypBeschreibung
visibilityVisibilityDie Visibility des Widgets.

Rückflug

Widget – Das Objekt für die Verkettung.

setWrapStyle(wrapStyle)

Legt den Umbruchstil der Spalten fest und steuert, wie die Spalte basierend auf der Bildschirmbreite angepasst wird. 

const columns = CardService.newColumns()
                    .addColumn(CardService.newColumn())
                    .setWrapStyle(CardService.WrapStyle.WRAP);

Parameter

NameTypBeschreibung
wrapStyleWrapStyleDer Umbruchstil, der für die Spalten festgelegt werden soll.

Rückflug

Columns: Dieses Objekt zur Verkettung.