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étodo	Tipo de datos que se devuelve	Descripción breve
addWidget(widget)	CardSection	Agrega el widget determinado a esta sección.
setCollapseControl(collapseControl)	CardSection	Establece los botones de expansión y contracción personalizables de la sección.
setCollapsible(collapsible)	CardSection	Establece si la sección se puede contraer.
setHeader(header)	CardSection	Establece el encabezado de la sección.
setId(id)	CardSection	Establece el ID único asignado que se usa para identificar la sección que se modificará.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)	CardSection	Establece 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

Nombre	Tipo	Descripción
widget	Widget	Es 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. En la versión preliminar para desarrolladores de los complementos de Google Workspace

Versión preliminar para desarrolladores: Disponible como parte del Programa de versión preliminar para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones.

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

Nombre	Tipo	Descripción
collapseControl	CollapseControl	Es 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

Nombre	Tipo	Descripción
collapsible	Boolean	Es 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

Nombre	Tipo	Descripción
header	String	Es 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

Nombre	Tipo	Descripción
id	String	Es 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 son siempre los primeros que se agregaron.

Parámetros

Nombre	Tipo	Descripción
numUncollapsibleWidgets	Integer	Es la cantidad de widgets que se mostrarán.

Volver

CardSection: Este objeto, para encadenar.