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設定區段的標頭。
setId(id)CardSection設定指派的專屬 ID，用於識別要變動的區段。
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 - 這個物件，用於鏈結。

setId(id)

設定指派的專屬 ID，用於識別要變動的區段。只有外掛程式支援區段突變。

參數

名稱類型說明
idString區段的 ID，最多 64 個字元，格式為 `[a-zA-Z0-9-]+`。

回攻員

CardSection - 這個物件，用於鏈結。

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

設定這個部分收合時仍會顯示的小工具數量。顯示的小工具一律是新增的第一個小工具。

參數

名稱類型說明
numUncollapsibleWidgetsInteger要顯示的小工具數量。

回攻員

CardSection - 這個物件，用於鏈結。