Class Columns

Spalten

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

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

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

  • 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.

Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. 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)ColumnsDem Spalten-Widget wird eine Column hinzugefügt.
setWrapStyle(wrapStyle)ColumnsLegt den Umbruchstil der Spalten fest und steuert, wie sich die Spalte je nach Bildschirmbreite ändert.

Detaillierte Dokumentation

addColumn(column)

Dem Spalten-Widget wird eine Column hinzugefügt. 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


setWrapStyle(wrapStyle)

Legt den Umbruchstil der Spalten fest und steuert, wie sich die Spalte je nach Bildschirmbreite ändert.

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

Parameter

NameTypBeschreibung
wrapStyleWrapStyleDer für die Spalten festzulegende Wrapping-Stil.

Rückflug

Columns: Dieses Objekt zur Verkettung.