Class GridItem
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
مورد گرید مواردی که کاربران با آنها در یک ویجت شبکه تعامل دارند.
برای افزونههای Google Workspace و برنامههای Google Chat موجود است.
برای فراخوانی یک enum، کلاس والد، نام و ویژگی آن را فراخوانی می کنید. به عنوان مثال، CardService.GridItemLayout.TEXT_BELOW
.
const gridItem = CardService.newGridItem()
.setIdentifier('itemA')
.setTitle('This is a cat')
.setImage(CardService.newImageComponent())
.setLayout(CardService.GridItemLayout.TEXT_BELOW);
مستندات دقیق
set Identifier(id)
شناسه مورد گرید را تنظیم می کند. هنگامی که کاربر روی این آیتم شبکه کلیک می کند، این شناسه در پارامترهای برگشت تماس on_click شبکه والد برگردانده می شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|
id | String | شناسه |
بازگشت
Grid Item
- این شی، برای زنجیر کردن.
set Image(image)
تصویر را برای این مورد شبکه تنظیم می کند.
پارامترها
بازگشت
Grid Item
- این شی، برای زنجیر کردن.
set Layout(layout)
طرح بندی متن و تصویر را برای آیتم گرید تنظیم می کند. پیش فرض TEXT_BELOW است
پارامترها
بازگشت
Grid Item
- این شی، برای زنجیر کردن.
set Subtitle(subtitle)
زیرنویس مورد شبکه را تنظیم می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|
subtitle | String | متن زیرنویس |
بازگشت
Grid Item
- این شی، برای زنجیر کردن.
set Text Alignment(alignment)
تراز افقی مورد شبکه را تنظیم می کند. پیش فرض START است.
پارامترها
بازگشت
Grid Item
- این شی، برای زنجیر کردن.
set Title(title)
متن عنوان مورد شبکه را تنظیم می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|
title | String | متن عنوان |
بازگشت
Grid Item
- این شی، برای زنجیر کردن.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]