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 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 para apps do Google Chat. Na prévia para desenvolvedores dos complementos do Google Workspace.

Prévia para desenvolvedores:disponível como parte do Programa de prévia para desenvolvedores do Google Workspace, que concede acesso antecipado a determinados recursos.

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.