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：這個物件用於鏈結。