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將指定的小工具新增至這個部分。
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：這個物件用於鏈結。