Class SelectionInput

चुना गयाइनपुट

ऐसा इनपुट फ़ील्ड जिसमें पहले से तय विकल्पों के सेट में से कोई विकल्प चुना जा सकता है.

सिर्फ़ SelectionInputType.DROP_DOWN और SelectionInputType.MULTI_SELECT मेन्यू के लिए, फ़ॉर्म सबमिशन की पुष्टि करने की सुविधा काम करती है. जब Action.setAllWidgetsAreRequired(allWidgetsAreRequired) को true पर सेट किया जाता है या इस विजेट को Action.addRequiredWidget(requiredWidget) के ज़रिए तय किया जाता है, तो वैल्यू चुनने तक सबमिशन ऐक्शन ब्लॉक रहता है.

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);

तरीके

तरीका	रिटर्न टाइप	संक्षिप्त विवरण
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 — चेन करने के लिए यह ऑब्जेक्ट.