卡片部分用于容纳一组微件,并在它们之间提供视觉分隔。
适用于 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)
setHeader(header)
setNumUncollapsibleWidgets(numUncollapsibleWidgets)
设置在该部分收起时仍会显示的微件数量。显示的微件始终是添加的第一个微件。
参数
名称 | 类型 | 说明 |
---|---|---|
numUncollapsibleWidgets | Integer | 要显示的 widget 的数量。 |
返回
CardSection
- 此对象,用于实现链式连接。