Class Columns

列

Columns widget 最多可在卡片或对话框中显示 2 列。您可以将微件添加到 每Column；这些微件会按指定顺序显示。如需 Google Chat 应用，请参阅列。

每列的高度由较高的列决定。例如，如果第一列 高于第二列，则两列都具有第一列的高度。因为每个 列中可以包含不同数量的微件，您无法定义行或对齐微件之间的 。

列将并排显示。您可以使用 HorizontalSizeStyle 字段。如果用户的屏幕宽度太窄，第二列 封装在第一个行下方：

  • 在网站上，如果屏幕宽度小于或等于 480 像素，则第二列会换行。
  • 在 iOS 设备上，如果屏幕宽度小于或等于 300，则第二列会换行 分
  • 在 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将 Column 添加到“列”微件中。
setWrapStyle(wrapStyle)Columns设置列的环绕样式，控制如何根据屏幕宽度调整列的大小。

详细文档

addColumn(column)

将 Column 添加到“列”微件中。系统会按照 就会被选中您最多可以添加两列。 

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

参数

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

返回

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

setWrapStyle(wrapStyle)

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

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

参数

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

返回

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