Esta página foi traduzida pela API Cloud Translation.

Class CardSection

Uma seção de cards contém grupos de widgets e fornece uma separação visual entre eles.

Disponível para os apps do Google Workspace e 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étodo	Tipo de retorno	Breve descrição
`addWidget(widget)`	`CardSection`	Adiciona o widget especificado a esta seção.
`setCollapseControl(collapseControl)`	`CardSection`	Define os botões de abertura e fechamento personalizáveis da seção.
`setCollapsible(collapsible)`	`CardSection`	Define se a seção pode ser recolhida.
`setHeader(header)`	`CardSection`	Define o cabeçalho da seção.
`setNumUncollapsibleWidgets(numUncollapsibleWidgets)`	`CardSection`	Define 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

Nome	Tipo	Descrição
`widget`	`Widget`	Um 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ó serão mostrados se a seção puder ser fechada. Se este campo não for definido, os botões padrão serão usados.

Disponível apenas para apps do Google Chat. Não disponível para 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

Nome	Tipo	Descrição
`collapseControl`	`CollapseControl`	A configuração do controle de recolhimento.

Retornar

CardSection: este objeto, para encadeamento.

`setCollapsible(collapsible)`

Define se a seção pode ser recolhida.

Parâmetros

Nome	Tipo	Descrição
`collapsible`	`Boolean`	A configuração que pode ser fechada.

Retornar

CardSection: este objeto, para encadeamento.

`setHeader(header)`

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

Parâmetros

Nome	Tipo	Descrição
`header`	`String`	O 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

Nome	Tipo	Descrição
`numUncollapsibleWidgets`	`Integer`	O número de widgets a serem mostrados.

Retornar

CardSection: este objeto, para encadeamento.