Esta página foi traduzida pela API Cloud Translation.

Class CardSection

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

Disponível para os apps do Google Workspace Add-ons 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ão mostrados apenas se a seção puder ser recolhida. Se esse 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 retração.

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 recolhida.

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.