Class ChipList
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
方塊清單保留一組以列顯示的 Chip
物件,並將其換行,以便水平捲動。
適用於 Google Chat 應用程式。在 Google Workspace 外掛程式的開發人員預覽版中。
const chip = CardService.newChip();
// Finish building the text chip...
const chipList = CardService.newChipList()
.setLayout(CardService.ChipListLayout.WRAPPED)
.addChip(chip);
內容詳盡的說明文件
setLayout(layout)
設定方塊清單版面配置。如果未設定,則預設為 ChipListLayout.WRAPPED
版面配置。
const chip = CardService.newChip();
// Finish building the text chip...
const chipList =
CardService.newChipList()
.setLayout(CardService.ChipListLayout.HORIZONTAL_SCROLLABLE)
.addChip(chip);
參數
回攻員
ChipList
:這個物件用於鏈結。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eChipList displays a set of Chip objects in a row, wrapping to the next line or horizontally scrolling.\u003c/p\u003e\n"],["\u003cp\u003eIt's available for Google Chat apps and in developer preview for Google Workspace Add-ons.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use \u003ccode\u003eaddChip()\u003c/code\u003e to add chips and \u003ccode\u003esetLayout()\u003c/code\u003e to configure the layout of the ChipList.\u003c/p\u003e\n"]]],[],null,["# Class ChipList\n\nChipList\n\nHolds a set of [Chip](/apps-script/reference/card-service/chip) objects that are displayed in a row, wrapping to the next line to\nhorizontal scrollable.\n\nAvailable for Google Chat apps. In developer preview for Google Workspace add-ons.\n\n\n| **Developer Preview:** Available as part of the [Google Workspace Developer Preview Program](https://developers.google.com/workspace/preview), which grants early access to certain features.\n\n\u003cbr /\u003e\n\n```javascript\nconst chip = CardService.newChip();\n// Finish building the text chip...\n\nconst chipList = CardService.newChipList()\n .setLayout(CardService.ChipListLayout.WRAPPED)\n .addChip(chip);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------|---------------|----------------------------|\n| [addChip(chip)](#addChip(Chip)) | [ChipList](#) | Adds a chip. |\n| [setLayout(layout)](#setLayout(ChipListLayout)) | [ChipList](#) | Sets the chip list layout. |\n\nDetailed documentation\n----------------------\n\n### `add``Chip(chip)`\n\nAdds a chip.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------|--------------------------------------------------|------------------|\n| `chip` | [Chip](/apps-script/reference/card-service/chip) | The chip to add. |\n\n#### Return\n\n\n[ChipList](#) --- This object, for chaining.\n\n*** ** * ** ***\n\n### `set``Layout(layout)`\n\nSets the chip list layout. If unset, it defaults to [ChipListLayout.WRAPPED](/apps-script/reference/card-service/chip-list-layout#WRAPPED) layout.\n\n```javascript\nconst chip = CardService.newChip();\n// Finish building the text chip...\n\nconst chipList =\n CardService.newChipList()\n .setLayout(CardService.ChipListLayout.HORIZONTAL_SCROLLABLE)\n .addChip(chip);\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|------------------------------------------------------------------------|-----------------------|\n| `layout` | [ChipListLayout](/apps-script/reference/card-service/chip-list-layout) | The chip list layout. |\n\n#### Return\n\n\n[ChipList](#) --- This object, for chaining."]]