इनपुट फ़ील्ड विजेट, जो टेक्स्ट इनपुट स्वीकार करता है.
यह सुविधा, Google Workspace ऐड-ऑन और Google Chat ऐप्लिकेशन के लिए उपलब्ध है.
var textInput = CardService.newTextInput() .setFieldName("text_input_form_input_key") .setTitle("Text input title") .setHint("Text input hint");
तरीके
तरीका | रिटर्न टाइप | संक्षिप्त विवरण |
---|---|---|
setFieldName(fieldName) | TextInput | वह कुंजी सेट करती है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में इस टेक्स्ट इनपुट की पहचान करती है. |
setHint(hint) | TextInput | टेक्स्ट इनपुट के लिए संकेत सेट करता है. |
setMultiline(multiline) | TextInput | सेट करता है कि इनपुट टेक्स्ट एक लाइन में दिखे या कई लाइनों पर. |
setOnChangeAction(action) | TextInput | टेक्स्ट इनपुट के बदलने पर, की जाने वाली कार्रवाई सेट करता है. |
setSuggestions(suggestions) | TextInput | टेक्स्ट फ़ील्ड में अपने-आप पूरा होने के लिए सुझाव सेट करता है. |
setSuggestionsAction(suggestionsAction) | TextInput | अपने-आप पूरा होने के लिए, उपयोगकर्ता के इनपुट के आधार पर सुझाव फ़ेच करने के लिए, कॉलबैक ऐक्शन सेट करता है. |
setTitle(title) | TextInput | इनपुट फ़ील्ड के ऊपर दिखाए जाने वाले शीर्षक को सेट करता है. |
setValue(value) | TextInput | इनपुट फ़ील्ड में पहले से भरी गई वैल्यू को सेट करता है. |
ज़्यादा जानकारी वाला दस्तावेज़
setFieldName(fieldName)
वह कुंजी सेट करती है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट होने वाले इवेंट ऑब्जेक्ट में इस टेक्स्ट इनपुट की पहचान करती है. उपयोगकर्ता को नहीं दिखेगा. यह ज़रूरी है और यूनीक होना चाहिए.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
fieldName | String | इस इनपुट की पहचान करने के लिए इस्तेमाल की जाने वाली कुंजी. |
रिटर्न
TextInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setHint(hint)
टेक्स्ट इनपुट के लिए संकेत सेट करता है. इसका इस्तेमाल, उपयोगकर्ता को जानकारी देने के लिए किया जाता है. उदाहरण के लिए, संकेत किसी फ़ोन नंबर फ़ील्ड के लिए फ़ॉर्मैटिंग ("xxx-xxx-xxxx") के बारे में बता सकता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
hint | String | इनपुट फ़ील्ड के नीचे दिखने के लिए टेक्स्ट संकेत. यह टेक्स्ट हमेशा दिखता है. |
रिटर्न
TextInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setMultiline(multiline)
सेट करता है कि इनपुट टेक्स्ट एक लाइन में दिखे या कई लाइनों पर.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
multiline | Boolean | मल्टीलाइन सेटिंग. |
रिटर्न
TextInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setOnChangeAction(action)
setSuggestions(suggestions)
टेक्स्ट फ़ील्ड में अपने-आप पूरा होने के लिए सुझाव सेट करता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
suggestions | Suggestions | इस्तेमाल करने के लिए सुझावों का कलेक्शन. |
रिटर्न
TextInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setSuggestionsAction(suggestionsAction)
अपने-आप पूरा होने के लिए, उपयोगकर्ता के इनपुट के आधार पर सुझाव फ़ेच करने के लिए, कॉलबैक ऐक्शन सेट करता है. यह ज़रूरी है कि
Action
पैरामीटर में एक कॉलबैक फ़ंक्शन दिया गया हो, जो SuggestionsResponse
ऑब्जेक्ट को दिखाता हो.
var action = CardService.newAction() .setFunctionName('suggestionCallback') .setParameters({'numSuggestions': 3}); CardService.newTextInput() .setFieldName('option-field') .setTitle('Option Selected') .setSuggestionsAction(action); // ... function suggestionCallback(e) { var suggestions = CardService.newSuggestions(); var numSuggestions = parseInt(e.parameter['numSuggestions']); for(var i = 1; i <= numSuggestions; i++) { suggestions.addSuggestion('Suggestion ' + i); } return CardService.newSuggestionsResponseBuilder() .setSuggestions(suggestions) .build(); }
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
suggestionsAction | Action | वह कार्रवाई जो इस इनपुट के लिए सुझाव फ़ेच करती है. |
रिटर्न
TextInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setTitle(title)
इनपुट फ़ील्ड के ऊपर दिखाए जाने वाले शीर्षक को सेट करता है. ज़रूरी है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
title | String | इस इनपुट के लिए टेक्स्ट लेबल. |
रिटर्न
TextInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.
setValue(value)
इनपुट फ़ील्ड में पहले से भरी गई वैल्यू को सेट करता है.
पैरामीटर
नाम | टाइप | ब्यौरा |
---|---|---|
value | String | इनपुट में मौजूद डिफ़ॉल्ट वैल्यू. इसे फ़ॉर्म के कॉलबैक पैरामीटर में हमेशा एक स्ट्रिंग के तौर पर दिखाया जाता है. |
रिटर्न
TextInput
— यह ऑब्जेक्ट, चेन बनाने के लिए है.