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

Parâmetros

Nome	Tipo	Descrição
widget	Widget	Um widget a ser adicionado à seção.

Retornar

CardSection: esse objeto, para encadeamento.

---

setCollapseControl(collapseControl)

Define os botões personalizáveis de expansão e recolhimento da seção. Esses botões só são mostrados se a seção puder ser recolhida. Se esse campo não estiver definido, os botões padrão serão usados.

Disponível para apps do Google Chat. Na prévia para desenvolvedores de complementos do Google Workspace.

Prévia para desenvolvedores: disponível como parte do Programa de testes 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 de controle de recolhimento.

Retornar

CardSection: esse objeto, para encadeamento.

---

setCollapsible(collapsible)

Define se a seção pode ser recolhida.

Parâmetros

Nome	Tipo	Descrição
collapsible	Boolean	A configuração recolhível.

Retornar

CardSection: esse 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: esse objeto, para encadeamento.

---

setId(id)

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

Parâmetros

Nome	Tipo	Descrição
id	String	O ID da seção, com um limite de 64 caracteres e no formato `[a-zA-Z0-9-]+`.

Retornar

CardSection: esse objeto, para encadeamento.

---

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

Define o número de widgets que ainda são mostrados quando essa seção é 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: esse objeto, para encadeamento.