Class CardSection

Kartenbereich

Ein Kartenbereich 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

MethodeRückgabetypKurzbeschreibung
addWidget(widget)CardSectionFügen Sie diesem Bereich das angegebene Widget hinzu.
setCollapseControl(collapseControl)CardSectionHier legen Sie die benutzerdefinierten Schaltflächen zum Maximieren und Minimieren des Bereichs fest.
setCollapsible(collapsible)CardSectionLegen Sie fest, ob der Bereich minimiert werden kann.
setHeader(header)CardSectionLegt die Überschrift des Abschnitts fest.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSectionHier legen Sie fest, wie viele Widgets angezeigt werden, wenn dieser Bereich minimiert ist.

Detaillierte Dokumentation

addWidget(widget)

Fügen Sie diesem Bereich das angegebene Widget hinzu. Widgets werden in der Reihenfolge angezeigt, in der sie hinzugefügt wurden. Sie können einem Kartenbereich nicht mehr als 100 Widgets hinzufügen.

Parameter

NameTypBeschreibung
widgetWidgetEin Widget, das dem Abschnitt hinzugefügt werden soll.

Rückflug

CardSection – dieses Objekt, zur Verkettung


setCollapseControl(collapseControl)

Hier legen Sie die benutzerdefinierten Schaltflächen zum Maximieren und Minimieren des Bereichs fest. Diese Schaltflächen werden nur angezeigt, wenn der Bereich minimiert werden kann. Wenn dieses Feld nicht festgelegt ist, werden Standardschaltflächen verwendet.

Nur für Google Chat-Apps verfügbar. Nicht verfügbar für Google Workspace-Add-ons.

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

NameTypBeschreibung
collapseControlCollapseControlDie Einstellung für die Minimierungssteuerung.

Rückflug

CardSection – dieses Objekt, zur Verkettung


setCollapsible(collapsible)

Legen Sie fest, ob der Bereich minimiert werden kann.

Parameter

NameTypBeschreibung
collapsibleBooleanDie minimierbare Einstellung.

Rückflug

CardSection – dieses Objekt, zur Verkettung


setHeader(header)

Legt die Überschrift des Abschnitts fest. Optional.

Parameter

NameTypBeschreibung
headerStringDen Headertext.

Rückflug

CardSection – dieses Objekt, zur Verkettung


setNumUncollapsibleWidgets(numUncollapsibleWidgets)

Hier legen Sie fest, wie viele Widgets angezeigt werden, wenn dieser Bereich minimiert ist. Die angezeigten Widgets sind immer die ersten, die hinzugefügt wurden.

Parameter

NameTypBeschreibung
numUncollapsibleWidgetsIntegerDie Anzahl der anzuzeigenden Widgets.

Rückflug

CardSection – dieses Objekt, zur Verkettung