Class Columns

列

Columns widget 在卡片或对话框中最多可显示 2 列。您可以向每个 Column 添加微件；微件会按照指定的顺序显示。如需查看 Google Chat 应用中的示例，请参阅列。

每列的高度由较高列决定。例如，如果第一列比第二列高，则这两列的高度都与第一列相同。由于每列可以包含不同数量的 widget，因此您无法定义行或在列之间对齐 widget。

列会并排显示。您可以使用 HorizontalSizeStyle 字段自定义各列的宽度。如果用户的屏幕宽度过窄，第二列会换行显示在第一列下方：

  • 在网站上，如果屏幕宽度小于或等于 480 像素，则第二列会换行。
  • 在 iOS 设备上，如果屏幕宽度小于或等于 300 pt，则第二列会换行。
  • 在 Android 设备上，如果屏幕宽度小于或等于 320 dp，则第二列会换行。

适用于 Google Chat 应用和 Google Workspace 插件。支持列的插件界面包括：

  • 当用户从电子邮件草稿打开插件时显示的对话框。
  • 当用户从 Google 日历活动中的添加附件菜单打开插件时，系统会显示的对话框。 
    // 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);

方法

方法返回类型简介
addColumn(column)Columns向“Columns”微件添加了 Column。
setWrapStyle(wrapStyle)Columns设置列的换行样式，控制列根据屏幕宽度调整大小的方式。

详细文档

addColumn(column)

向“Columns”微件添加了 Column。列会按添加的顺序显示。您最多可以添加两列。 

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

参数

名称类型说明
columnColumn要添加到 Columns 微件的子列。

返回

Columns - 此对象，用于链式调用。

setWrapStyle(wrapStyle)

设置列的换行样式，控制列如何根据屏幕宽度调整大小。 

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

参数

名称类型说明
wrapStyleWrapStyle要为列设置的换行样式。

返回

Columns - 此对象，用于链式调用。