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。

参数

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

返回

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),
        );

参数

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

返回

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

setCollapsible(collapsible)

设置该部分是否可收起。

参数

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

返回

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

setHeader(header)

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

参数

名称类型说明
headerString标题文字。

返回

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

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

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

参数

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

返回

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