Class CardSection

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 个微件。

参数

名称类型说明
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 - 此对象,用于实现链式连接。