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
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
add | Card | Fügen Sie diesem Bereich das angegebene Widget hinzu. |
set | Card | Hier legen Sie die benutzerdefinierten Schaltflächen zum Maximieren und Minimieren des Bereichs fest. |
set | Card | Legen Sie fest, ob der Bereich minimiert werden kann. |
set | Card | Legt die Überschrift des Abschnitts fest. |
set | Card | Hier legen Sie fest, wie viele Widgets angezeigt werden, wenn dieser Bereich minimiert ist. |
Detaillierte Dokumentation
add Widget(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
Name | Typ | Beschreibung |
---|---|---|
widget | Widget | Ein Widget, das dem Abschnitt hinzugefügt werden soll. |
Rückflug
Card
– dieses Objekt, zur Verkettung
set Collapse Control(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.
Verfügbar für Google Chat-Apps. 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
Name | Typ | Beschreibung |
---|---|---|
collapse | Collapse | Die Einstellung für die Minimierungssteuerung. |
Rückflug
Card
– dieses Objekt, zur Verkettung
set Collapsible(collapsible)
Legen Sie fest, ob der Bereich minimiert werden kann.
Parameter
Name | Typ | Beschreibung |
---|---|---|
collapsible | Boolean | Die minimierbare Einstellung. |
Rückflug
Card
– dieses Objekt, zur Verkettung
set Header(header)
Legt die Überschrift des Abschnitts fest. Optional.
Parameter
Name | Typ | Beschreibung |
---|---|---|
header | String | Den Headertext. |
Rückflug
Card
– dieses Objekt, zur Verkettung
set Num Uncollapsible Widgets(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
Name | Typ | Beschreibung |
---|---|---|
num | Integer | Die Anzahl der anzuzeigenden Widgets. |
Rückflug
Card
– dieses Objekt, zur Verkettung