Class UpdatedWidget
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Widget mis à jour
Réponse du widget mis à jour. Permet de fournir des options de saisie semi-automatique pour le menu de sélection multiple dans 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',
);
Disponible uniquement pour les applications Google Chat. Non disponible pour les modules complémentaires Google Workspace.
Documentation détaillée
addItem(text, value, selected, startIconUri, bottomText)
Ajoute un élément pouvant être sélectionné.
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',
);
Disponible uniquement pour les applications Google Chat. Non disponible pour les modules complémentaires Google Workspace.
Paramètres
| Nom | Type | Description |
text | Object | Texte à afficher pour cet élément. Les arguments primitifs autres que des chaînes sont automatiquement convertis en chaînes. |
value | Object | Valeur d'entrée du formulaire envoyée via le rappel. Les arguments primitifs autres que des chaînes sont convertis automatiquement en chaînes. |
selected | Boolean | Indique si l'élément est sélectionné par défaut. Si la zone de saisie de sélection n'accepte qu'une seule valeur (par exemple, pour les boutons d'option ou un menu déroulant), ne définissez ce champ que pour un seul élément. |
startIconUri | Object | Pour les menus à sélection multiple, URL de l'icône affichée à côté du champ de texte de l'élément. Compatible avec les fichiers PNG et JPEG. |
bottomText | Object | Pour les menus à sélection multiple, description ou libellé textuel affiché sous le champ de texte de l'élément. |
Renvois
UpdatedWidget : cet objet, pour le chaînage.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\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."]]
