Class CardSection

Sección de la tarjeta

Una sección de tarjeta contiene grupos de widgets y proporciona una separación visual entre ellos.

Disponible para los complementos de Google Workspace y las apps de 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 datos que se muestraDescripción breve
addWidget(widget)CardSectionAgrega el widget determinado a esta sección.
setCollapseControl(collapseControl)CardSectionEstablece los botones personalizables de expansión y contracción de la sección.
setCollapsible(collapsible)CardSectionEstablece si la sección se puede contraer.
setHeader(header)CardSectionEstablece el encabezado de la sección.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSectionEstablece la cantidad de widgets que aún se muestran cuando se contrae esta sección.

Documentación detallada

addWidget(widget)

Agrega el widget determinado a esta sección. Los widgets se muestran en el orden en que se agregaron. No puedes agregar más de 100 widgets a una sección de tarjetas.

Parámetros

NombreTipoDescripción
widgetWidgetEs un widget que se agregará a la sección.

Volver

CardSection: Este objeto, para encadenar.


setCollapseControl(collapseControl)

Establece los botones personalizables de expansión y contracción de la sección. Estos botones solo se muestran si la sección se puede contraer. Si no se configura este campo, se usarán los botones predeterminados.

Disponible para las apps de Google Chat. En la versión preliminar para desarrolladores de complementos de 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

NombreTipoDescripción
collapseControlCollapseControlEs el parámetro de configuración del control de colapso.

Volver

CardSection: Este objeto, para encadenar.


setCollapsible(collapsible)

Establece si la sección se puede contraer.

Parámetros

NombreTipoDescripción
collapsibleBooleanEl parámetro de configuración que se puede contraer.

Volver

CardSection: Este objeto, para encadenar.


setHeader(header)

Establece el encabezado de la sección. Opcional.

Parámetros

NombreTipoDescripción
headerStringEs el texto del encabezado.

Volver

CardSection: Este objeto, para encadenar.


setNumUncollapsibleWidgets(numUncollapsibleWidgets)

Establece la cantidad de widgets que aún se muestran cuando se contrae esta sección. Los widgets que se muestran siempre son los primeros que se agregaron.

Parámetros

NombreTipoDescripción
numUncollapsibleWidgetsIntegerEs la cantidad de widgets que se mostrarán.

Volver

CardSection: Este objeto, para encadenar.