Class CardSection

CardSection

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 personalizáveis de abrir e fechar da seção.
setCollapsible(collapsible)CardSectionDefine se a seção pode ser recolhida.
setHeader(header)CardSectionDefine o cabeçalho da seção.
setId(id)CardSectionDefine o ID exclusivo atribuído que é usado para identificar a seção a ser modificada.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSectionDefine o número de widgets que ainda são mostrados quando esta seção é 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 a ser adicionado à seção.

Retornar

CardSection: este objeto, para encadeamento.

setCollapseControl(collapseControl)

Define os botões personalizáveis de abrir e fechar da seção. Esses botões só aparecem se a seção puder ser recolhida. 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 de controle de recolhimento.

Retornar

CardSection: este objeto, para encadeamento.

setCollapsible(collapsible)

Define se a seção pode ser recolhida.

Parâmetros

NomeTipoDescrição
collapsibleBooleanA configuração de capacidade de recolhimento.

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.

setId(id)

Define o ID exclusivo atribuído que é usado para identificar a seção a ser modificada. A mutação de seção é compatível apenas com complementos.

Parâmetros

NomeTipoDescrição
idStringO ID da seção, com um limite de 64 caracteres e no formato `[a-zA-Z0-9-]+`.

Retornar

CardSection: este objeto, para encadeamento.

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

Define o número de widgets que ainda são mostrados quando esta seção é 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.