Class CardSection

Seção do cartão

Uma seção de card contém grupos de widgets e oferece separação visual entre eles.

Disponível para complementos do Google Workspace e apps do 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);

Métodos

MétodoTipo de retornoBreve descrição
addWidget(widget)CardSectionAdiciona o widget especificado a esta seção.
setCollapseControl(collapseControl)CardSectionDefine os botões de abertura e fechamento personalizáveis da seção.
setCollapsible(collapsible)CardSectionDefine se a seção pode ser recolhida.
setHeader(header)CardSectionDefine o cabeçalho da seção.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSectionDefine o número de widgets que ainda são mostrados quando essa seção está recolhida.

Documentação detalhada

addWidget(widget)

Adiciona o widget especificado a esta seção. Os widgets são mostrados na ordem em que foram adicionados. Não é possível adicionar mais de 100 widgets a uma seção de cards.

Parâmetros

NomeTipoDescrição
widgetWidgetUm widget para adicionar à seção.

Retornar

CardSection: este objeto, para encadeamento.

setCollapseControl(collapseControl)

Define os botões de abertura e fechamento personalizáveis da seção. Esses botões são mostrados apenas se a seção for colapsável. Se esse campo não for definido, os botões padrão serão usados.

Disponível para apps do Google Chat. Na prévia para desenvolvedores dos complementos do 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),
        );

Parâmetros

NomeTipoDescrição
collapseControlCollapseControlA configuração do controle de retração.

Retornar

CardSection: este objeto, para encadeamento.

setCollapsible(collapsible)

Define se a seção pode ser recolhida.

Parâmetros

NomeTipoDescrição
collapsibleBooleanA configuração que pode ser recolhida.

Retornar

CardSection: este objeto, para encadeamento.

setHeader(header)

Define o cabeçalho da seção. Opcional.

Parâmetros

NomeTipoDescrição
headerStringO texto do cabeçalho.

Retornar

CardSection: este objeto, para encadeamento.

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

Define o número de widgets que ainda são mostrados quando essa seção está recolhida. Os widgets mostrados são sempre os primeiros que foram adicionados.

Parâmetros

NomeTipoDescrição
numUncollapsibleWidgetsIntegerO número de widgets a serem mostrados.

Retornar

CardSection: este objeto, para encadeamento.