ऐसा इनपुट फ़ील्ड जिसमें पहले से तय विकल्पों के सेट में से कोई विकल्प चुना जा सकता है.
Google Workspace के ऐड-ऑन और Google Chat ऐप्लिकेशन के लिए उपलब्ध है.
const 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'), ); const 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);
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
add | Selection | एक नया आइटम जोड़ता है, जिसे चुना जा सकता है. |
add | Selection | एक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू के लिए, एक नया आइटम जोड़ता है. |
set | Selection | बाहरी डेटा सोर्स सेट करता है, जैसे कि रिलेशनल डेटाबेस. |
set | Selection | वह कुंजी सेट करता है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में, इस चुनिंदा इनपुट की पहचान करता है. |
set | Selection | इससे यह तय होता है कि कोई उपयोगकर्ता ज़्यादा से ज़्यादा कितने आइटम चुन सकता है. |
set | Selection | यह टेक्स्ट वर्ण की संख्या सेट करता है. उपयोगकर्ता इस संख्या के हिसाब से टेक्स्ट डालता है. इसके बाद, ऐप्लिकेशन ऑटोकंप्लीट की सुविधा का इस्तेमाल करके, कार्ड पर सुझाए गए आइटम दिखाता है. |
set | Selection | चुने गए इनपुट में बदलाव होने पर, Action को सेट करता है. |
set | Selection | Google Workspace से डेटा सोर्स सेट करता है. |
set | Selection | इनपुट फ़ील्ड के आगे दिखने वाला टाइटल सेट करता है. |
set | Selection | इस इनपुट का टाइप सेट करता है. |
ज़्यादा जानकारी वाला दस्तावेज़
add Item(text, value, selected)
एक नया आइटम जोड़ता है, जिसे चुना जा सकता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
text | Object | इस आइटम के लिए दिखाया जाने वाला टेक्स्ट. नॉन-स्ट्रिंग प्राइमिटिव आर्ग्युमेंट, अपने-आप स्ट्रिंग में बदल जाते हैं. |
value | Object | कॉलबैक के ज़रिए भेजी गई फ़ॉर्म इनपुट वैल्यू. स्ट्रिंग प्राइमटिव आर्ग्युमेंट के अलावा, अन्य आर्ग्युमेंट को स्ट्रिंग में अपने-आप बदल दिया जाता है. |
selected | Boolean | आइटम डिफ़ॉल्ट रूप से चुना गया है या नहीं. अगर चुनने के लिए दिया गया इनपुट सिर्फ़ एक वैल्यू स्वीकार करता है, जैसे कि रेडियो बटन या ड्रॉपडाउन मेन्यू के लिए, तो इस फ़ील्ड को सिर्फ़ एक आइटम के लिए सेट करें. |
वापसी का टिकट
Selection
— चेन करने के लिए यह ऑब्जेक्ट.
add Multi Select Item(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 | आइटम डिफ़ॉल्ट रूप से चुना गया है या नहीं. अगर चुनने के लिए दिया गया इनपुट सिर्फ़ एक वैल्यू स्वीकार करता है, जैसे कि रेडियो बटन या ड्रॉपडाउन मेन्यू के लिए, तो इस फ़ील्ड को सिर्फ़ एक आइटम के लिए सेट करें. |
start | Object | एक से ज़्यादा आइटम चुनने की सुविधा वाले मेन्यू के लिए, आइटम के टेक्स्ट फ़ील्ड के बगल में दिखने वाले आइकॉन का यूआरएल. PNG और JPEG फ़ाइलों के साथ काम करता है. |
bottom | Object | एक से ज़्यादा विकल्प वाले मेन्यू के लिए, आइटम के टेक्स्ट फ़ील्ड के नीचे दिखने वाला टेक्स्ट ब्यौरा या लेबल. |
वापसी का टिकट
Selection
— चेन करने के लिए यह ऑब्जेक्ट.
set External Data Source(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 | बाहरी डेटा सोर्स. |
वापसी का टिकट
Selection
— चेन करने के लिए यह ऑब्जेक्ट.
set Field Name(fieldName)
वह कुंजी सेट करता है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में, इस चुनिंदा इनपुट की पहचान करता है. यह उपयोगकर्ता को नहीं दिखता. यह ज़रूरी है और यूनीक होना चाहिए.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
field | String | इस इनपुट को असाइन किया जाने वाला नाम. |
वापसी का टिकट
Selection
— चेन करने के लिए यह ऑब्जेक्ट.
set Multi Select Max Selected Items(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', );
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
max | Integer | आइटम की ज़्यादा से ज़्यादा संख्या. |
वापसी का टिकट
Selection
— चेन करने के लिए यह ऑब्जेक्ट.
set Multi Select Min Query Length(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', );
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
query | Integer | टेक्स्ट में वर्णों की संख्या. |
वापसी का टिकट
Selection
— चेन करने के लिए यह ऑब्जेक्ट.
set On Change Action(action)
चुने गए इनपुट में बदलाव होने पर, Action
को सेट करता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
action | Action | की जाने वाली कार्रवाई. |
वापसी का टिकट
Selection
— चेन करने के लिए यह ऑब्जेक्ट.
set Platform Data Source(platformDataSource)
Google Workspace से डेटा सोर्स सेट करता है. इसका इस्तेमाल, एक से ज़्यादा आइटम चुनने वाले मेन्यू में आइटम भरने के लिए किया जाता है.
const multiSelect = CardService.newSelectionInput() .setType(CardService.SelectionInputType.MULTI_SELECT) .setFieldName('contacts') .setTitle('Selected contacts') .setPlatformDataSource( CardService.newPlatformDataSource().setCommonDataSource( CardService.CommonDataSource.USER, ), );
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
platform | Platform | डेटा सोर्स. |
वापसी का टिकट
Selection
— चेन करने के लिए यह ऑब्जेक्ट.
set Title(title)
इनपुट फ़ील्ड के आगे दिखने वाला टाइटल सेट करता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
title | String | इनपुट फ़ील्ड का टाइटल. |
वापसी का टिकट
Selection
— चेन करने के लिए यह ऑब्जेक्ट.
set Type(type)
इस इनपुट का टाइप सेट करता है. डिफ़ॉल्ट रूप से, यह CHECKBOX
पर सेट होती है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
type | Selection | चुनने का तरीका. |
वापसी का टिकट
Selection
— चेन करने के लिए यह ऑब्जेक्ट.