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

MethodeRückgabetypKurzbeschreibung
addWidget(widget)CardSectionFügt diesem Bereich das angegebene Widget hinzu.
setCollapseControl(collapseControl)CardSectionLegt die anpassbaren Schaltflächen zum Maximieren und Minimieren des Bereichs fest.
setCollapsible(collapsible)CardSectionLegt fest, ob der Bereich minimiert werden kann.
setHeader(header)CardSectionLegt die Überschrift des Abschnitts fest.
setId(id)CardSectionLegt die eindeutige ID fest, die zum Identifizieren des zu ändernden Abschnitts verwendet wird.
setNumUncollapsibleWidgets(numUncollapsibleWidgets)CardSectionLegt die Anzahl der Widgets fest, die weiterhin angezeigt werden, wenn dieser Bereich minimiert ist.

Detaillierte Dokumentation

addWidget(widget)

Fügt 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)

Legt die anpassbaren 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.

Für Google Chat-Apps verfügbar. In der Entwicklervorschau 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 Minimierung.

Rückflug

CardSection: Dieses Objekt zur Verkettung.

setCollapsible(collapsible)

Legt fest, ob der Bereich minimiert werden kann.

Parameter

NameTypBeschreibung
collapsibleBooleanDie Einstellung zum Minimieren.

Rückflug

CardSection: Dieses Objekt zur Verkettung.

setHeader(header)

Legt die Überschrift des Abschnitts fest. Optional.

Parameter

NameTypBeschreibung
headerStringDer Headertext.

Rückflug

CardSection: Dieses Objekt zur Verkettung.

setId(id)

Legt die eindeutige ID fest, die zum Identifizieren des zu ändernden Abschnitts verwendet wird. Die Mutation von Abschnitten wird nur in Add-ons unterstützt.

Parameter

NameTypBeschreibung
idStringDie ID des Abschnitts mit einem Limit von 64 Zeichen und im Format `[a-zA-Z0-9-]+`.

Rückflug

CardSection: Dieses Objekt zur Verkettung.

setNumUncollapsibleWidgets(numUncollapsibleWidgets)

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

Parameter

NameTypBeschreibung
numUncollapsibleWidgetsIntegerAnzahl der anzuzeigenden Widgets.

Rückflug

CardSection: Dieses Objekt zur Verkettung.