Class Columns

列

Columns widget 在卡片或对话框中最多可显示 2 列。您可以向每个 Column 添加 widget；widget 会按照指定的顺序显示。如需查看 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());

参数

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

返回

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

---

setWrapStyle(wrapStyle)

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

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

参数

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

返回

Columns - 此对象，用于实现链式连接。