Class GridItem
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ตารางรายการ
รายการที่ผู้ใช้โต้ตอบภายในวิดเจ็ตตารางกริด
พร้อมใช้งานสำหรับส่วนเสริมของ Google Workspace และแอป Google Chat
หากต้องการเรียกใช้ enum ให้เรียกคลาสหลัก ชื่อ และพร็อพเพอร์ตี้ของ enum นั้น เช่น
CardService.GridItemLayout.TEXT_BELOW
const gridItem = CardService.newGridItem()
.setIdentifier('itemA')
.setTitle('This is a cat')
.setImage(CardService.newImageComponent())
.setLayout(CardService.GridItemLayout.TEXT_BELOW);
เอกสารประกอบโดยละเอียด
setIdentifier(id)
ตั้งค่าตัวระบุสำหรับรายการตารางกริด เมื่อผู้ใช้คลิกรายการตารางกริดนี้ ระบบจะแสดงรหัสนี้ในพารามิเตอร์การเรียกกลับ on_click ของตารางกริดหลัก
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
id | String | รหัส |
รีเทิร์น
GridItem — ออบเจ็กต์นี้สําหรับการต่อเชื่อม
setImage(image)
ตั้งค่ารูปภาพสำหรับรายการตารางกริดนี้
พารามิเตอร์
รีเทิร์น
GridItem — ออบเจ็กต์นี้สําหรับการต่อเชื่อม
setLayout(layout)
กำหนดเลย์เอาต์ของข้อความและรูปภาพสำหรับรายการตารางกริด ค่าเริ่มต้นคือ TEXT_BELOW
พารามิเตอร์
รีเทิร์น
GridItem — ออบเจ็กต์นี้สําหรับการต่อเชื่อม
setSubtitle(subtitle)
ตั้งค่าชื่อรองของรายการตารางกริด
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
subtitle | String | ข้อความชื่อรอง |
รีเทิร์น
GridItem — ออบเจ็กต์นี้สําหรับการต่อเชื่อม
setTextAlignment(alignment)
ตั้งค่าการจัดแนวแนวนอนของรายการตารางกริด ค่าเริ่มต้นคือ START
พารามิเตอร์
รีเทิร์น
GridItem — ออบเจ็กต์นี้สําหรับการต่อเชื่อม
setTitle(title)
ตั้งค่าข้อความชื่อของรายการตารางกริด
พารามิเตอร์
| ชื่อ | ประเภท | คำอธิบาย |
title | String | ข้อความชื่อ |
รีเทิร์น
GridItem — ออบเจ็กต์นี้สําหรับการต่อเชื่อม
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-26 UTC
[null,null,["อัปเดตล่าสุด 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."]]
