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étodo | Tipo de datos que se muestra | Descripción breve |
---|---|---|
addWidget(widget) | CardSection | Agrega el widget determinado a esta sección. |
setCollapseControl(collapseControl) | CardSection | Establece los botones personalizables de expansión y contracción 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. |
setNumUncollapsibleWidgets(numUncollapsibleWidgets) | CardSection | Establece 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
Nombre | Tipo | Descripción |
---|---|---|
widget | Widget | Es un widget para 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.
Solo está disponible para las apps de Google Chat. No está disponible para 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
Nombre | Tipo | Descripción |
---|---|---|
collapseControl | CollapseControl | Es 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
Nombre | Tipo | Descripción |
---|---|---|
collapsible | Boolean | El 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
Nombre | Tipo | Descripción |
---|---|---|
header | String | Es 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
Nombre | Tipo | Descripción |
---|---|---|
numUncollapsibleWidgets | Integer | Es la cantidad de widgets que se mostrarán. |
Volver
CardSection
: Este objeto, para encadenar.