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 - チェーン用のこのオブジェクト。