ऐसा यूज़र इंटरफ़ेस (यूआई) एलिमेंट जो टॉगल करके चालू या बंद करने की सुविधा देता है. इसका इस्तेमाल सिर्फ़ DecoratedText
विजेट में किया जा सकता है.
यह सुविधा, Google Workspace ऐड-ऑन और Google Chat ऐप्लिकेशन के लिए उपलब्ध है.
var switchDecoratedText = CardService.newDecoratedText() .setTopLabel("Switch decorated text widget label") .setText("This is a decorated text widget with a switch on the right") .setWrapText(true) .setSwitchControl(CardService.newSwitch() .setFieldName("form_input_switch_key") .setValue("form_input_switch_value") .setOnChangeAction(CardService.newAction() .setFunctionName("handleSwitchChange")));
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
setControlType(controlType) | Switch | स्विच का कंट्रोल टाइप सेट करता है. |
setFieldName(fieldName) | Switch | वह कुंजी सेट करती है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में, इस स्विच की पहचान करती है. |
setOnChangeAction(action) | Switch | स्विच टॉगल होने पर की जाने वाली कार्रवाई सेट करता है. |
setSelected(selected) | Switch | सेट करता है कि यह स्विच 'चुने गए' के तौर पर शुरू होना चाहिए या नहीं. |
setValue(value) | Switch | यह स्विच चालू होने पर, फ़ॉर्म इनपुट के तौर पर भेजी जाने वाली वैल्यू सेट करता है. |
ज़्यादा जानकारी वाला दस्तावेज़
setControlType(controlType)
स्विच का कंट्रोल टाइप सेट करता है. डिफ़ॉल्ट वैल्यू SWITCH
होती है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
controlType | SwitchControlType | स्विच कंट्रोल का टाइप. |
रिटर्न
Switch
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setFieldName(fieldName)
वह कुंजी सेट करती है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में, इस स्विच की पहचान करती है. उपयोगकर्ता को नहीं दिखेगा. ज़रूरी है.
अन्य फ़ॉर्म फ़ील्ड के उलट, इस फ़ील्ड के नाम का यूनीक होना ज़रूरी नहीं है. एक जैसे फ़ील्ड नाम का इस्तेमाल करने वाले स्विच के लिए, फ़ॉर्म इनपुट वैल्यू एक अरे के तौर पर दिखाई जाती हैं. इस कैटगरी में, उस फ़ील्ड नाम वाले सभी चालू स्विच की वैल्यू शामिल होती हैं.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
fieldName | String | इस स्विच की पहचान के लिए इस्तेमाल की गई कुंजी. |
रिटर्न
Switch
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setOnChangeAction(action)
setSelected(selected)
सेट करता है कि यह स्विच 'चुने गए' के तौर पर शुरू होना चाहिए या नहीं.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
selected | Boolean | स्विच स्थिति की शुरुआती सेटिंग. |
रिटर्न
Switch
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setValue(value)
यह स्विच चालू होने पर, फ़ॉर्म इनपुट के तौर पर भेजी जाने वाली वैल्यू सेट करता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
value | String | स्विच चालू होने पर, नाम से जुड़ी वैल्यू. जब इसे फ़ॉर्म कॉलबैक पर भेजा जाता है, तो इसे हमेशा एक स्ट्रिंग के तौर पर दिखाया जाता है. |
रिटर्न
Switch
— यह ऑब्जेक्ट, चेन बनाने के लिए है.