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 |
---|---|---|
add | Card | Agrega el widget determinado a esta sección. |
set | Card | Establece los botones personalizables de expansión y contracción de la sección. |
set | Card | Establece si la sección se puede contraer. |
set | Card | Establece el encabezado de la sección. |
set | Card | Establece la cantidad de widgets que aún se muestran cuando se contrae esta sección. |
Documentación detallada
add Widget(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
Card
: Este objeto, para encadenar.
set Collapse Control(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
Nombre | Tipo | Descripción |
---|---|---|
collapse | Collapse | Es el parámetro de configuración del control de colapso. |
Volver
Card
: Este objeto, para encadenar.
set Collapsible(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
Card
: Este objeto, para encadenar.
set Header(header)
Establece el encabezado de la sección. Opcional.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
header | String | Es el texto del encabezado. |
Volver
Card
: Este objeto, para encadenar.
set Num Uncollapsible Widgets(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 |
---|---|---|
num | Integer | Es la cantidad de widgets que se mostrarán. |
Volver
Card
: Este objeto, para encadenar.