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將指定的小工具新增至這個部分。
setCollapseControl(collapseControl)CardSection設定可自訂的區段展開和收合按鈕。
setCollapsible(collapsible)CardSection設定是否可收合該區段。
setHeader(header)CardSection設定區段的標題。
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSection設定在該部分收合時仍會顯示的小工具數量。

內容詳盡的說明文件

addWidget(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要顯示的小工具數量。

回攻員

CardSection:用於鏈結的物件。