Class UpdatedWidget
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
已更新小工具
更新版小工具的回應。用於為 SelectionInput
中的多重選取選單提供自動完成選項。
const updatedWidget = CardService.newUpdatedWidget()
.addItem(
'item_one_title',
'item_one_value',
false,
'item_one_uri',
'item_one_bottom_text',
)
.addItem(
'item_two_title',
'item_two_value',
false,
'item_two_uri',
'item_two_bottom_text',
);
僅適用於 Google Chat 應用程式。不適用於 Google Workspace 外掛程式。
內容詳盡的說明文件
addItem(text, value, selected, startIconUri, bottomText)
新增可選取的新項目。
const updatedWidget = CardService.newUpdatedWidget()
.addItem(
'item_one_title',
'item_one_value',
false,
'item_one_uri',
'item_one_bottom_text',
)
.addItem(
'item_two_title',
'item_two_value',
false,
'item_two_uri',
'item_two_bottom_text',
);
僅適用於 Google Chat 應用程式。不適用於 Google Workspace 外掛程式。
參數
名稱 | 類型 | 說明 |
text | Object | 這個項目要顯示的文字。非字串原始引數會自動轉換為字串。 |
value | Object | 透過回呼傳送的表單輸入值。非字串原始引數會自動轉換為字串。 |
selected | Boolean | 該項目是否為預設選項。如果選取輸入內容只接受一個值 (例如圓形按鈕或下拉式選單),請只為一個項目設定這個欄位。 |
startIconUri | Object | 對於多重選取選單,則是項目文字欄位旁顯示的圖示網址。支援 PNG 和 JPEG 檔案。 |
bottomText | Object | 對於多重選取選單,則是顯示在項目文字欄位下方的文字說明或標籤。 |
回攻員
UpdatedWidget
:這個物件用於鏈結。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003e\u003ccode\u003eUpdatedWidget\u003c/code\u003e provides autocomplete options for multiselect menus in SelectionInput, specifically for Google Chat apps.\u003c/p\u003e\n"],["\u003cp\u003eIt allows adding items with customizable text, value, selection state, icon, and bottom text using the \u003ccode\u003eaddItem\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThis functionality is exclusive to Google Chat apps and is not available for Google Workspace Add-ons.\u003c/p\u003e\n"]]],[],null,["# Class UpdatedWidget\n\nUpdatedWidget\n\nThe response of the updated widget. Used to provide autocomplete options for multiselect menu in\n[SelectionInput](/apps-script/reference/card-service/selection-input).\n\n```javascript\nconst updatedWidget = CardService.newUpdatedWidget()\n .addItem(\n 'item_one_title',\n 'item_one_value',\n false,\n 'item_one_uri',\n 'item_one_bottom_text',\n )\n .addItem(\n 'item_two_title',\n 'item_two_value',\n false,\n 'item_two_uri',\n 'item_two_bottom_text',\n );\n```\n\nOnly available for Google Chat apps. Not available for Google Workspace add-ons. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------------------------------------------------------------|--------------------|---------------------------------------|\n| [addItem(text, value, selected, startIconUri, bottomText)](#addItem(Object,Object,Boolean,Object,Object)) | [UpdatedWidget](#) | Adds a new item that can be selected. |\n\nDetailed documentation\n----------------------\n\n### `add``Item(text, value, selected, startIconUri, bottomText)`\n\nAdds a new item that can be selected.\n\n```javascript\nconst updatedWidget = CardService.newUpdatedWidget()\n .addItem(\n 'item_one_title',\n 'item_one_value',\n false,\n 'item_one_uri',\n 'item_one_bottom_text',\n )\n .addItem(\n 'item_two_title',\n 'item_two_value',\n false,\n 'item_two_uri',\n 'item_two_bottom_text',\n );\n```\nOnly available for Google Chat apps. Not available for Google Workspace add-ons.\n\n#### Parameters\n\n| Name | Type | Description |\n|--------------------|-----------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `text` | `Object` | The text to be shown for this item. Non-string primitive arguments are converted to strings automatically. |\n| `value` | `Object` | The form input value that is sent via the callback. Non-string primitive arguments are converted to strings automatically. |\n| `selected` | `Boolean` | Whether the item is selected by default. If the selection input only accepts one value (such as for radio buttons or a dropdown menu), only set this field for one item. |\n| `start``Icon``Uri` | `Object` | For multiselect menus, the URL for the icon displayed next to the item's text field. Supports PNG and JPEG files. |\n| `bottom``Text` | `Object` | For multiselect menus, a text description or label that's displayed below the item's text field. |\n\n#### Return\n\n\n[UpdatedWidget](#) --- This object, for chaining."]]