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 |
---|---|---|
addWidget(widget) | CardSection | Fügen Sie diesem Bereich das angegebene Widget hinzu. |
setCollapseControl(collapseControl) | CardSection | Hier legen Sie die benutzerdefinierten Schaltflächen zum Maximieren und Minimieren des Bereichs fest. |
setCollapsible(collapsible) | CardSection | Legen Sie fest, ob der Bereich minimiert werden kann. |
setHeader(header) | CardSection | Legt die Überschrift des Abschnitts fest. |
setNumUncollapsibleWidgets(numUncollapsibleWidgets) | CardSection | Hier 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
Name | Typ | Beschreibung |
---|---|---|
widget | Widget | Ein 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
Name | Typ | Beschreibung |
---|---|---|
collapseControl | CollapseControl | Die Einstellung für die Minimierungssteuerung. |
Rückflug
CardSection
– dieses Objekt, zur Verkettung
setCollapsible(collapsible)
Legen Sie fest, ob der Bereich minimiert werden kann.
Parameter
Name | Typ | Beschreibung |
---|---|---|
collapsible | Boolean | Die minimierbare Einstellung. |
Rückflug
CardSection
– dieses Objekt, zur Verkettung
setHeader(header)
Legt die Überschrift des Abschnitts fest. Optional.
Parameter
Name | Typ | Beschreibung |
---|---|---|
header | String | Den 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
Name | Typ | Beschreibung |
---|---|---|
numUncollapsibleWidgets | Integer | Die Anzahl der anzuzeigenden Widgets. |
Rückflug
CardSection
– dieses Objekt, zur Verkettung