Class CardSection

CardSection

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

Está 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 de expansión y contracción personalizables de la sección.
setCollapsible(collapsible)CardSectionEstablece si la sección se puede contraer.
setHeader(header)CardSectionEstablece el encabezado de la sección.
setId(id)CardSectionEstablece el ID único asignado que se usa para identificar la sección que se modificará.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSectionEstablece la cantidad de widgets que se siguen mostrando 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 de expansión y contracción personalizables de la sección. Estos botones solo se muestran si la sección se puede contraer. Si no se establece este campo, se usan los botones predeterminados.

Disponible para las apps de Google Chat. Está disponible en la versión preliminar para desarrolladores de los 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 contraer.

Volver

CardSection: Este objeto, para encadenar.

setCollapsible(collapsible)

Establece si la sección se puede contraer.

Parámetros

NombreTipoDescripción
collapsibleBooleanEs el parámetro de configuración contraíble.

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.

setId(id)

Establece el ID único asignado que se usa para identificar la sección que se modificará. La mutación de secciones solo se admite en complementos.

Parámetros

NombreTipoDescripción
idStringEs el ID de la sección, con un límite de 64 caracteres y en formato de `[a-zA-Z0-9-]+`.

Volver

CardSection: Este objeto, para encadenar.

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

Establece la cantidad de widgets que se siguen mostrando 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.