ऐसा इनपुट फ़ील्ड जो पहले से तय विकल्पों के सेट में से किसी एक को चुनने की अनुमति देता है.
यह सुविधा, Google Workspace ऐड-ऑन और Google Chat ऐप्लिकेशन के लिए उपलब्ध है.
var checkboxGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.CHECK_BOX) .setTitle("A group of checkboxes. Multiple selections are allowed.") .setFieldName("checkbox_field") .addItem("checkbox one title", "checkbox_one_value", false) .addItem("checkbox two title", "checkbox_two_value", true) .addItem("checkbox three title", "checkbox_three_value", true) .setOnChangeAction(CardService.newAction() .setFunctionName("handleCheckboxChange")); var radioGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.RADIO_BUTTON) .setTitle("A group of radio buttons. Only a single selection is allowed.") .setFieldName("checkbox_field") .addItem("radio button one title", "radio_one_value", true) .addItem("radio button two title", "radio_two_value", false) .addItem("radio button three title", "radio_three_value", false); const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description") .setMultiSelectMaxSelectedItems(3) .setMultiSelectMinQueryLength(1);
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
addItem(text, value, selected) | SelectionInput | नया आइटम जोड़ता है, जिसे चुना जा सकता है. |
addMultiSelectItem(text, value, selected, startIconUri, bottomText) | SelectionInput | इससे एक नया आइटम जुड़ जाता है, जिसे एक से ज़्यादा विकल्पों वाले मेन्यू में चुना जा सकता है. |
setExternalDataSource(action) | SelectionInput | बाहरी डेटा सोर्स सेट करता है, जैसे कि रिलेशनल डेटा बेस. |
setFieldName(fieldName) | SelectionInput | वह कुंजी सेट करती है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में, चुने गए इस इनपुट की पहचान करती है. |
setMultiSelectMaxSelectedItems(maxSelectedItems) | SelectionInput | उपयोगकर्ताओं की ओर से चुने जा सकने वाले आइटम की ज़्यादा से ज़्यादा संख्या सेट करता है. |
setMultiSelectMinQueryLength(queryLength) | SelectionInput | यह सेटिंग, ऐप्लिकेशन में क्वेरी के ऑटोकंप्लीट होने से पहले, उपयोगकर्ता के डाले गए टेक्स्ट वर्णों की संख्या सेट करती है और कार्ड पर सुझाए गए आइटम दिखाता है. |
setOnChangeAction(action) | SelectionInput | चुने गए इनपुट के बदलने पर, Action को सेट किया जाता है. |
setPlatformDataSource(platformDataSource) | SelectionInput | Google Workspace से डेटा सोर्स सेट करता है. |
setTitle(title) | SelectionInput | इनपुट फ़ील्ड के आगे दिखाए जाने वाले शीर्षक को सेट करता है. |
setType(type) | SelectionInput | इस इनपुट का टाइप सेट करता है. |
ज़्यादा जानकारी वाला दस्तावेज़
addItem(text, value, selected)
नया आइटम जोड़ता है, जिसे चुना जा सकता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
text | Object | इस आइटम के लिए दिखाया जाने वाला टेक्स्ट. बिना स्ट्रिंग वाले प्रिमिटिव आर्ग्युमेंट, अपने-आप स्ट्रिंग में बदल जाते हैं. |
value | Object | कॉलबैक से भेजा जाने वाला फ़ॉर्म इनपुट वैल्यू. बिना स्ट्रिंग वाले प्रिमिटिव आर्ग्युमेंट अपने-आप स्ट्रिंग में बदल जाते हैं. |
selected | Boolean | आइटम डिफ़ॉल्ट रूप से चुना गया है या नहीं. अगर चुने गए इनपुट के लिए सिर्फ़ एक वैल्यू (जैसे कि रेडियो बटन या ड्रॉपडाउन मेन्यू) स्वीकार की जाती है, तो इस फ़ील्ड को सिर्फ़ एक आइटम के लिए सेट करें. |
रिटर्न
SelectionInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
addMultiSelectItem(text, value, selected, startIconUri, bottomText)
इससे एक नया आइटम जुड़ जाता है, जिसे एक से ज़्यादा विकल्पों वाले मेन्यू में चुना जा सकता है.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description");
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
text | Object | इस आइटम के लिए दिखाया जाने वाला टेक्स्ट. बिना स्ट्रिंग वाले प्रिमिटिव आर्ग्युमेंट, अपने-आप स्ट्रिंग में बदल जाते हैं. |
value | Object | कॉलबैक से भेजा जाने वाला फ़ॉर्म इनपुट वैल्यू. बिना स्ट्रिंग वाले प्रिमिटिव आर्ग्युमेंट अपने-आप स्ट्रिंग में बदल जाते हैं. |
selected | Boolean | आइटम डिफ़ॉल्ट रूप से चुना गया है या नहीं. अगर चुने गए इनपुट के लिए सिर्फ़ एक वैल्यू (जैसे कि रेडियो बटन या ड्रॉपडाउन मेन्यू) स्वीकार की जाती है, तो इस फ़ील्ड को सिर्फ़ एक आइटम के लिए सेट करें. |
startIconUri | Object | एक से ज़्यादा चुने गए मेन्यू के लिए, आइटम के टेक्स्ट फ़ील्ड के बगल में दिखाए गए आइकॉन का यूआरएल. PNG और JPEG फ़ाइलों के साथ काम करता है. |
bottomText | Object | एक से ज़्यादा चुने गए मेन्यू के लिए, आइटम के टेक्स्ट फ़ील्ड के नीचे दिखने वाला टेक्स्ट की जानकारी या लेबल. |
रिटर्न
SelectionInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setExternalDataSource(action)
बाहरी डेटा सोर्स सेट करता है, जैसे कि रिलेशनल डेटा बेस.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("contacts") .setTitle("Selected contacts") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .setMultiSelectMaxSelectedItems(5) .setMultiSelectMinQueryLength(2) .setExternalDataSource(CardService.newAction().setFunctionName("getContacts"));
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
action | Action | बाहरी डेटा सोर्स. |
रिटर्न
SelectionInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setFieldName(fieldName)
वह कुंजी सेट करती है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में, चुने गए इस इनपुट की पहचान करती है. उपयोगकर्ता को नहीं दिखेगा. यह ज़रूरी है और यूनीक होना चाहिए.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
fieldName | String | इस इनपुट को असाइन किया जाने वाला नाम. |
रिटर्न
SelectionInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setMultiSelectMaxSelectedItems(maxSelectedItems)
उपयोगकर्ताओं की ओर से चुने जा सकने वाले आइटम की ज़्यादा से ज़्यादा संख्या सेट करता है.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .setMultiSelectMaxSelectedItems(3) .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description");
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
maxSelectedItems | Integer | आइटम की ज़्यादा से ज़्यादा संख्या. |
रिटर्न
SelectionInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setMultiSelectMinQueryLength(queryLength)
यह सेटिंग, ऐप्लिकेशन में क्वेरी के ऑटोकंप्लीट होने से पहले, उपयोगकर्ता के डाले गए टेक्स्ट वर्णों की संख्या सेट करती है और कार्ड पर सुझाए गए आइटम दिखाता है.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("multiselect") .setTitle("A multi select input example.") .setMultiSelectMinQueryLength(1) .addMultiSelectItem("Contact 1", "contact-1", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact one description") .addMultiSelectItem("Contact 2", "contact-2", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact two description") .addMultiSelectItem("Contact 3", "contact-3", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact three description") .addMultiSelectItem("Contact 4", "contact-4", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact four description") .addMultiSelectItem("Contact 5", "contact-5", false, "https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png", "Contact five description");
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
queryLength | Integer | टेक्स्ट वर्णों की संख्या. |
रिटर्न
SelectionInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setOnChangeAction(action)
चुने गए इनपुट के बदलने पर, Action
को सेट किया जाता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
action | Action | की जाने वाली कार्रवाई. |
रिटर्न
SelectionInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setPlatformDataSource(platformDataSource)
Google Workspace से डेटा सोर्स सेट करता है. कई आइटम चुनने के मेन्यू में आइटम भरने के लिए इसका इस्तेमाल किया जाता है.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName("contacts") .setTitle("Selected contacts") .setPlatformDataSource( CardService.newPlatformDataSource() .setCommonDataSource(CardService.CommonDataSource.USER));सिर्फ़ Google Chat ऐप्लिकेशन के लिए उपलब्ध है. Google Workspace ऐड-ऑन के लिए उपलब्ध नहीं है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
platformDataSource | PlatformDataSource | डेटा सोर्स. |
रिटर्न
SelectionInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setTitle(title)
इनपुट फ़ील्ड के आगे दिखाए जाने वाले शीर्षक को सेट करता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
title | String | इनपुट फ़ील्ड का टाइटल. |
रिटर्न
SelectionInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setType(type)
इस इनपुट का टाइप सेट करता है. डिफ़ॉल्ट वैल्यू CHECKBOX
होती है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
type | SelectionInputType | चुनने का टाइप. |
रिटर्न
SelectionInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.