Cette page a été traduite par l'API Cloud Translation.

Class CardSection

Une section de fiche contient des groupes de widgets et les sépare visuellement.

Disponible pour les modules complémentaires Google Workspace et les applications 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éthodes

Méthode	Type renvoyé	Brève description
`addWidget(widget)`	`CardSection`	Ajoute le widget donné à cette section.
`setCollapseControl(collapseControl)`	`CardSection`	Définit les boutons de développement et de réduction personnalisables de la section.
`setCollapsible(collapsible)`	`CardSection`	Indique si la section peut être réduite.
`setHeader(header)`	`CardSection`	Définit l'en-tête de la section.
`setNumUncollapsibleWidgets(numUncollapsibleWidgets)`	`CardSection`	Définit le nombre de widgets qui s'affichent toujours lorsque cette section est réduite.

Documentation détaillée

`addWidget(widget)`

Ajoute le widget donné à cette section. Les widgets s'affichent dans l'ordre dans lequel ils ont été ajoutés. Vous ne pouvez pas ajouter plus de 100 widgets à une section de fiches.

Paramètres

Nom	Type	Description
`widget`	`Widget`	Widget à ajouter à la section.

Renvois

CardSection : cet objet, pour le chaînage.

`setCollapseControl(collapseControl)`

Définit les boutons de développement et de réduction personnalisables de la section. Ces boutons ne s'affichent que si la section est réductible. Si ce champ n'est pas défini, les boutons par défaut sont utilisés.

Disponible uniquement pour les applications Google Chat. Non disponible pour les modules complémentaires 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),
        );

Paramètres

Nom	Type	Description
`collapseControl`	`CollapseControl`	Paramètre de la commande de réduction.

Renvois

CardSection : cet objet, pour le chaînage.

`setCollapsible(collapsible)`

Indique si la section peut être réduite.

Paramètres

Nom	Type	Description
`collapsible`	`Boolean`	Paramètre de rétractabilité.

Renvois

CardSection : cet objet, pour le chaînage.

`setHeader(header)`

Définit l'en-tête de la section. Facultatif.

Paramètres

Nom	Type	Description
`header`	`String`	Texte de l'en-tête.

Renvois

CardSection : cet objet, pour le chaînage.

`setNumUncollapsibleWidgets(numUncollapsibleWidgets)`

Définit le nombre de widgets qui s'affichent toujours lorsque cette section est réduite. Les widgets affichés sont toujours les premiers ajoutés.

Paramètres

Nom	Type	Description
`numUncollapsibleWidgets`	`Integer`	Nombre de widgets à afficher.

Renvois

CardSection : cet objet, pour le chaînage.