Class CardSection

CardSection

Une section de fiche contient des groupes de widgets et assure une séparation visuelle entre eux.

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 personnalisables d'expansion et de réduction 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.
setId(id)	CardSection	Définit l'ID unique attribué qui est utilisé pour identifier la section à modifier.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)	CardSection	Définit le nombre de widgets qui sont toujours affichés lorsque cette section est réduite.

Documentation détaillée

addWidget(widget)

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

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 personnalisables d'expansion et de réduction de la section. Ces boutons ne s'affichent que si la section peut être réduite. Si ce champ n'est pas défini, les boutons par défaut sont utilisés.

Disponible pour les applications Google Chat. En preview développeur pour les modules complémentaires Google Workspace.

Preview développeur : disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

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 contrôle 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éduction.

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.

---

setId(id)

Définit l'ID unique attribué qui est utilisé pour identifier la section à modifier. La modification de section n'est compatible qu'avec les modules complémentaires.

Paramètres

Nom	Type	Description
id	String	ID de la section, avec une limite de 64 caractères et au format de `[a-zA-Z0-9-]+`.

Renvois

CardSection : cet objet, pour le chaînage.

---

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

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

Paramètres

Nom	Type	Description
numUncollapsibleWidgets	Integer	Nombre de widgets à afficher.

Renvois

CardSection : cet objet, pour le chaînage.