Class GridItem
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
RasterElement
Die Elemente, mit denen Nutzer in einem Raster-Widget interagieren.
Verfügbar für Google Workspace-Add-ons und Google Chat-Apps.
Wenn Sie ein Enum aufrufen möchten, rufen Sie die übergeordnete Klasse, den Namen und die Eigenschaft auf. Beispiel:
CardService.GridItemLayout.TEXT_BELOW.
const gridItem = CardService.newGridItem()
.setIdentifier('itemA')
.setTitle('This is a cat')
.setImage(CardService.newImageComponent())
.setLayout(CardService.GridItemLayout.TEXT_BELOW);
Detaillierte Dokumentation
setIdentifier(id)
Legt die Kennung für das Rasterelement fest. Wenn ein Nutzer auf dieses Rasterelement klickt, wird diese ID in den Rückgabeparametern „on_click“ des übergeordneten Rasters zurückgegeben.
Parameter
| Name | Typ | Beschreibung |
id | String | Die ID. |
Rückflug
GridItem – Dieses Objekt für die Verkettung.
setImage(image)
Hiermit wird das Bild für dieses Rasterelement festgelegt.
Parameter
Rückflug
GridItem – dieses Objekt, zur Verkettung
setLayout(layout)
Hiermit wird das Layout von Text und Bild für das Rasterelement festgelegt. Standardwert ist TEXT_BELOW
Parameter
Rückflug
GridItem – dieses Objekt, zur Verkettung
setSubtitle(subtitle)
Hiermit wird der Untertitel des Rasterelements festgelegt.
Parameter
| Name | Typ | Beschreibung |
subtitle | String | Der Untertiteltext. |
Rückflug
GridItem – Dieses Objekt für die Verkettung.
setTextAlignment(alignment)
Legt die horizontale Ausrichtung des Rasterelements fest. Standard ist START.
Parameter
Rückflug
GridItem – dieses Objekt, zur Verkettung
setTitle(title)
Hiermit wird der Titeltext des Rasterelements festgelegt.
Parameter
| Name | Typ | Beschreibung |
title | String | Der Titeltext. |
Rückflug
GridItem – dieses Objekt, zur Verkettung
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003eGridItem represents interactive elements within a grid widget, usable in Google Workspace Add-ons and Chat apps.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can set an identifier, image, layout, subtitle, text alignment, and title for each GridItem.\u003c/p\u003e\n"],["\u003cp\u003eWhen a user clicks a GridItem, its identifier is returned in the parent grid's on_click callback, enabling interactive functionality.\u003c/p\u003e\n"],["\u003cp\u003eGridItem leverages \u003ccode\u003eCardService\u003c/code\u003e methods for customization, such as \u003ccode\u003esetTitle()\u003c/code\u003e, \u003ccode\u003esetImage()\u003c/code\u003e, and \u003ccode\u003esetLayout()\u003c/code\u003e, to define its appearance and behavior.\u003c/p\u003e\n"],["\u003cp\u003eDefault settings include TEXT_BELOW for layout and START for text alignment, offering a base configuration for GridItems.\u003c/p\u003e\n"]]],["Grid items, used in grid widgets for Google Workspace add-ons and Chat apps, are configured using methods like `setIdentifier`, `setImage`, `setLayout`, `setSubtitle`, `setTextAlignment`, and `setTitle`. These methods respectively assign an ID, an image, a text/image layout, a subtitle, text alignment, and a title. The `setIdentifier` method's ID is returned upon a user click. Default layout is `TEXT_BELOW` and the default alignment is `START`. Each method returns the `GridItem` object, enabling chaining.\n"],null,["# Class GridItem\n\nGridItem\n\nThe items users interact with within a grid widget.\n\nAvailable for Google Workspace add-ons and Google Chat apps.\n\nTo call an enum, you call its parent class, name, and property. For example, `\nCardService.GridItemLayout.TEXT_BELOW`.\n\n```javascript\nconst gridItem = CardService.newGridItem()\n .setIdentifier('itemA')\n .setTitle('This is a cat')\n .setImage(CardService.newImageComponent())\n .setLayout(CardService.GridItemLayout.TEXT_BELOW);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------------------------|---------------|------------------------------------------------------|\n| [setIdentifier(id)](#setIdentifier(String)) | [GridItem](#) | Sets the identifier for the grid item. |\n| [setImage(image)](#setImage(ImageComponent)) | [GridItem](#) | Sets the image for this grid item. |\n| [setLayout(layout)](#setLayout(GridItemLayout)) | [GridItem](#) | Sets the layout of text and image for the grid item. |\n| [setSubtitle(subtitle)](#setSubtitle(String)) | [GridItem](#) | Sets the subtitle of the grid item. |\n| [setTextAlignment(alignment)](#setTextAlignment(HorizontalAlignment)) | [GridItem](#) | Sets the horizontal alignment of the grid item. |\n| [setTitle(title)](#setTitle(String)) | [GridItem](#) | Sets the title text of the grid item. |\n\nDetailed documentation\n----------------------\n\n### `set``Identifier(id)`\n\nSets the identifier for the grid item. When a user clicks this grid item, this ID is returned\nin the parent grid's on_click call back parameters.\n\n#### Parameters\n\n| Name | Type | Description |\n|------|----------|-------------|\n| `id` | `String` | The ID. |\n\n#### Return\n\n\n[GridItem](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Image(image)`\n\nSets the image for this grid item.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|-----------------------------------------------------------------------|----------------------------|\n| `image` | [ImageComponent](/apps-script/reference/card-service/image-component) | The ImageComponent object. |\n\n#### Return\n\n\n[GridItem](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Layout(layout)`\n\nSets the layout of text and image for the grid item. Default is TEXT_BELOW\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|------------------------------------------------------------------------|---------------------|\n| `layout` | [GridItemLayout](/apps-script/reference/card-service/grid-item-layout) | The layout setting. |\n\n#### Return\n\n\n[GridItem](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Subtitle(subtitle)`\n\nSets the subtitle of the grid item.\n\n#### Parameters\n\n| Name | Type | Description |\n|------------|----------|--------------------|\n| `subtitle` | `String` | The subtitle text. |\n\n#### Return\n\n\n[GridItem](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Text``Alignment(alignment)`\n\nSets the horizontal alignment of the grid item. Default is START.\n\n#### Parameters\n\n| Name | Type | Description |\n|-------------|---------------------------------------------------------------------------------|------------------------|\n| `alignment` | [HorizontalAlignment](/apps-script/reference/card-service/horizontal-alignment) | The alignment setting. |\n\n#### Return\n\n\n[GridItem](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Title(title)`\n\nSets the title text of the grid item.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------|----------|-----------------|\n| `title` | `String` | The title text. |\n\n#### Return\n\n\n[GridItem](#) --- This object, for chaining."]]
