Class CardSection

卡片部分

卡片部分用于容纳一组微件，并在它们之间提供视觉分隔。

适用于 Google Workspace 插件和 Google Chat 应用。

const image = CardService.newImage();
// Build image ...
const textParagraph = CardService.newTextParagraph();
// Build text paragraph ...

const cardSection = CardService.newCardSection()
                        .setHeader('Section header')
                        .addWidget(image)
                        .addWidget(textParagraph);

方法

方法	返回类型	简介
addWidget(widget)	CardSection	将给定 widget 添加到此部分。
setCollapseControl(collapseControl)	CardSection	设置该部分的可自定义展开和收起按钮。
setCollapsible(collapsible)	CardSection	设置该部分是否可收起。
setHeader(header)	CardSection	设置该部分的标题。
setNumUncollapsibleWidgets(numUncollapsibleWidgets)	CardSection	设置在该部分收起时仍显示的微件数量。

详细文档

addWidget(widget)

将给定 widget 添加到此部分。微件会按照添加的顺序显示。您最多只能向卡片版块添加 100 个微件。

参数

名称	类型	说明
widget	Widget	要添加到该版块的微件。

返回

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

---

setCollapseControl(collapseControl)

设置该部分的可自定义展开和收起按钮。只有当该部分可收起时，才会显示这些按钮。如果未设置此字段，则使用默认按钮。

仅适用于 Google Chat 应用。不适用于 Google Workspace 插件。

const collapseButton =
    CardService.newTextButton()
        .setTextButtonStyle(CardService.TextButtonStyle.BORDERLESS)
        .setText('show less');

const expandButton =
    CardService.newImageButton()
        .setImageButtonStyle(CardService.ImageButtonStyle.FILLED)
        .setMaterialIcon(CardService.newMaterialIcon().setName('bug_report'));

const collapsibleSection =
    CardService.newCardSection()
        .setCollapsible(true)
        .setNumUncollapsibleWidgets(1)
        .setCollapseControl(
            CardService.newCollapseControl()
                .setHorizontalAlign(CardService.HorizontalAlignment.CENTER)
                .setCollapseButton(collapseButton)
                .setExpandButton(expandButton),
        );

参数

名称	类型	说明
collapseControl	CollapseControl	收起控件设置。

返回

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

---

setCollapsible(collapsible)

设置该部分是否可收起。

参数

名称	类型	说明
collapsible	Boolean	可收起的设置。

返回

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

---

setHeader(header)

设置该部分的标题。可选。

参数

名称	类型	说明
header	String	标题文字。

返回

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

---

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

设置在该部分收起时仍会显示的微件数量。显示的微件始终是添加的第一个微件。

参数

名称	类型	说明
numUncollapsibleWidgets	Integer	要显示的 widget 的数量。

返回

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