Class CardSection

CardSection

Ein Kartenabschnitt enthält Gruppen von Widgets und sorgt für eine visuelle Trennung zwischen ihnen.

Verfügbar für Google Workspace-Add‑ons und Google Chat-Apps.

const image = CardService.newImage();
// Build image ...
const textParagraph = CardService.newTextParagraph();
// Build text paragraph ...

const cardSection = CardService.newCardSection()
                        .setHeader('Section header')
                        .addWidget(image)
                        .addWidget(textParagraph);

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
addWidget(widget)	CardSection	Fügt dieses Widget diesem Abschnitt hinzu.
setCollapseControl(collapseControl)	CardSection	Legt die anpassbaren Schaltflächen zum Maximieren und Minimieren des Abschnitts fest.
setCollapsible(collapsible)	CardSection	Legt fest, ob der Abschnitt minimiert werden kann.
setHeader(header)	CardSection	Legt die Kopfzeile des Abschnitts fest.
setId(id)	CardSection	Legt die eindeutige ID fest, die zur Identifizierung des zu ändernden Abschnitts verwendet wird.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)	CardSection	Legt die Anzahl der Widgets fest, die weiterhin angezeigt werden, wenn dieser Abschnitt minimiert ist.

Detaillierte Dokumentation

addWidget(widget)

Fügt dieses Widget diesem Abschnitt hinzu. Widgets werden in der Reihenfolge angezeigt, in der sie hinzugefügt wurden. Einem Kartenabschnitt können maximal 100 Widgets hinzugefügt werden.

Parameter

Name	Typ	Beschreibung
widget	Widget	Ein Widget, das dem Abschnitt hinzugefügt werden soll.

Rückgabe

CardSection : Dieses Objekt zur Verkettung.

---

setCollapseControl(collapseControl)

Legt die anpassbaren Schaltflächen zum Maximieren und Minimieren des Abschnitts fest. Diese Schaltflächen werden nur angezeigt, wenn der Abschnitt minimiert werden kann. Wenn dieses Feld nicht festgelegt ist, werden Standardschaltflächen verwendet.

Verfügbar für Google Chat-Apps. In der Entwicklervorschau für Google Workspace-Add‑ons.

Entwicklervorschau: Verfügbar im Rahmen des Google Workspace-Entwicklervorschauprogramms, das frühen Zugriff auf bestimmte Funktionen bietet.

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),
        );

Parameter

Name	Typ	Beschreibung
collapseControl	CollapseControl	Die Einstellung für die Minimierung.

Rückgabe

CardSection : Dieses Objekt zur Verkettung.

---

setCollapsible(collapsible)

Legt fest, ob der Abschnitt minimiert werden kann.

Parameter

Name	Typ	Beschreibung
collapsible	Boolean	Die Einstellung für die Minimierung.

Rückgabe

CardSection : Dieses Objekt zur Verkettung.

---

setHeader(header)

Legt die Kopfzeile des Abschnitts fest. Optional.

Parameter

Name	Typ	Beschreibung
header	String	Der Kopfzeilentext.

Rückgabe

CardSection : Dieses Objekt zur Verkettung.

---

setId(id)

Legt die eindeutige ID fest, die zur Identifizierung des zu ändernden Abschnitts verwendet wird. Abschnittsänderungen werden nur in Add‑ons unterstützt.

Parameter

Name	Typ	Beschreibung
id	String	Die ID des Abschnitts mit einer Beschränkung von 64 Zeichen und im Format `[a-zA-Z0-9-]+`.

Rückgabe

CardSection : Dieses Objekt zur Verkettung.

---

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

Legt die Anzahl der Widgets fest, die weiterhin angezeigt werden, wenn dieser Abschnitt minimiert ist. Die angezeigten Widgets sind immer die ersten, die hinzugefügt wurden.

Parameter

Name	Typ	Beschreibung
numUncollapsibleWidgets	Integer	Die Anzahl der anzuzeigenden Widgets.

Rückgabe

CardSection : Dieses Objekt zur Verkettung.