Class TextInput

टेक्स्टइनपुट

यह एक इनपुट फ़ील्ड विजेट है, जो टेक्स्ट इनपुट स्वीकार करता है.

फ़ॉर्म सबमिट करने की पुष्टि करने की सुविधा उपलब्ध है. Action.setAllWidgetsAreRequired(allWidgetsAreRequired) को true पर सेट करने या Action.addRequiredWidget(requiredWidget) के ज़रिए इस विजेट को तय करने पर, सबमिट करने की कार्रवाई तब तक ब्लॉक रहती है, जब तक कोई वैल्यू नहीं डाली जाती.

यह सुविधा, Google Workspace ऐड-ऑन और Google Chat ऐप्लिकेशन के लिए उपलब्ध है.

const textInput = CardService.newTextInput()
                      .setFieldName('text_input_form_input_key')
                      .setTitle('Text input title')
                      .setHint('Text input hint');

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
setFieldName(fieldName)TextInputयह उस कुंजी को सेट करता है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट किए गए इवेंट ऑब्जेक्ट में इस टेक्स्ट इनपुट की पहचान करती है.
setHint(hint)TextInputइस विकल्प से, टेक्स्ट इनपुट के लिए हिंट सेट किया जाता है.
setHostAppDataSource(hostAppDataSource)TextInputGoogle Workspace ऐप्लिकेशन से डेटा सोर्स सेट करता है.
setMultiline(multiline)TextInputइससे यह तय होता है कि इनपुट टेक्स्ट एक लाइन में दिखेगा या कई लाइनों में.
setOnChangeAction(action)TextInputइस कुकी का इस्तेमाल, टेक्स्ट इनपुट में बदलाव होने पर कोई कार्रवाई सेट करने के लिए किया जाता है.
setSuggestions(suggestions)TextInputयह विकल्प, टेक्स्ट फ़ील्ड में अपने-आप पूरा होने की सुविधा के लिए सुझाव सेट करता है.
setSuggestionsAction(suggestionsAction)TextInputयह कुकी, अपने-आप पूरा होने की सुविधा के लिए उपयोगकर्ता के इनपुट के आधार पर सुझाव पाने के लिए, कॉलबैक ऐक्शन सेट करती है.
setTitle(title)TextInputइससे इनपुट फ़ील्ड के ऊपर दिखने वाला टाइटल सेट किया जाता है.
setValidation(validation)TextInputयह विकल्प, इस विजेट के लिए पुष्टि करने का नियम सेट करता है.
setValue(value)TextInputइनपुट फ़ील्ड में पहले से भरी गई वैल्यू सेट करता है.

ज़्यादा जानकारी वाला दस्तावेज़

setFieldName(fieldName)

यह उस कुंजी को सेट करता है जो यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन होने पर जनरेट किए गए इवेंट ऑब्जेक्ट में इस टेक्स्ट इनपुट की पहचान करती है. यह उपयोगकर्ता को नहीं दिखेगा. यह ज़रूरी है और यूनीक होना चाहिए.

पैरामीटर

नामटाइपब्यौरा
fieldNameStringइस इनपुट की पहचान करने के लिए इस्तेमाल की जाने वाली कुंजी.

वापसी का टिकट

TextInput — यह ऑब्जेक्ट, चेनिंग के लिए है.


setHint(hint)

इस विकल्प से, टेक्स्ट इनपुट के लिए हिंट सेट किया जाता है. इस कुकी का इस्तेमाल, उपयोगकर्ता को यह बताने के लिए किया जाता है कि उसे क्या इनपुट करना है. उदाहरण के लिए, किसी फ़ोन नंबर फ़ील्ड के लिए, हिंट में फ़ॉर्मैट ("xxx-xxx-xxxx") के बारे में बताया जा सकता है.

पैरामीटर

नामटाइपब्यौरा
hintStringइनपुट फ़ील्ड के नीचे दिखाने के लिए टेक्स्ट हिंट. यह टेक्स्ट हमेशा दिखता है.

वापसी का टिकट

TextInput — यह ऑब्जेक्ट, चेनिंग के लिए.


setHostAppDataSource(hostAppDataSource)

Google Workspace ऐप्लिकेशन से डेटा सोर्स सेट करता है. फ़िलहाल, यह सुविधा उपयोगकर्ताओं और Chat स्पेस के लिए उपलब्ध है.

यह सुविधा सिर्फ़ Gemini Alpha प्रोग्राम के ज़रिए उपलब्ध है. यह Google Workspace के ऐड-ऑन के लिए है, जो Google Workspace Flows को बेहतर बनाते हैं.

const workflowDataSource =
    CardService.newWorkflowDataSource().setIncludeVariables(true);

const hostAppDataSource =
    CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource);

const textInput = CardService.newTextInput()
                      .setFieldName('text_input_form_input_key')
                      .setTitle('Text input title')
                      .setHint('Text input hint')
                      .setHostAppDataSource(hostAppDataSource);

पैरामीटर

नामटाइपब्यौरा
hostAppDataSourceHostAppDataSourceडेटा सोर्स.

वापसी का टिकट

TextInput — यह ऑब्जेक्ट, चेनिंग के लिए.


setMultiline(multiline)

इससे यह तय होता है कि इनपुट टेक्स्ट एक लाइन में दिखेगा या कई लाइनों में.

पैरामीटर

नामटाइपब्यौरा
multilineBooleanमल्टीलाइन सेटिंग.

वापसी का टिकट

TextInput — यह ऑब्जेक्ट, चेनिंग के लिए.


setOnChangeAction(action)

इस कुकी का इस्तेमाल, टेक्स्ट इनपुट में बदलाव होने पर कोई कार्रवाई सेट करने के लिए किया जाता है.

पैरामीटर

नामटाइपब्यौरा
actionActionकी जाने वाली कार्रवाई.

वापसी का टिकट

TextInput — यह ऑब्जेक्ट, चेनिंग के लिए.


setSuggestions(suggestions)

यह विकल्प, टेक्स्ट फ़ील्ड में अपने-आप पूरा होने की सुविधा के लिए सुझाव सेट करता है.

पैरामीटर

नामटाइपब्यौरा
suggestionsSuggestionsइस्तेमाल किए जाने वाले सुझावों का कलेक्शन.

वापसी का टिकट

TextInput — यह ऑब्जेक्ट, चेनिंग के लिए.


setSuggestionsAction(suggestionsAction)

यह कुकी, अपने-आप पूरा होने की सुविधा के लिए उपयोगकर्ता के इनपुट के आधार पर सुझाव पाने के लिए, कॉलबैक ऐक्शन सेट करती है. Action पैरामीटर में, एक ऐसा कॉलबैक फ़ंक्शन तय करना होगा जो SuggestionsResponse ऑब्जेक्ट दिखाता है.

const action = CardService.newAction()
                   .setFunctionName('suggestionCallback')
                   .setParameters({numSuggestions: 3});

CardService.newTextInput()
    .setFieldName('option-field')
    .setTitle('Option Selected')
    .setSuggestionsAction(action);

// ...

function suggestionCallback(e) {
  const suggestions = CardService.newSuggestions();
  const numSuggestions = Number.parseInt(e.parameter.numSuggestions);
  for (let i = 1; i <= numSuggestions; i++) {
    suggestions.addSuggestion(`Suggestion ${i}`);
  }
  return CardService.newSuggestionsResponseBuilder()
      .setSuggestions(suggestions)
      .build();
}

पैरामीटर

नामटाइपब्यौरा
suggestionsActionActionयह कार्रवाई, इस इनपुट के लिए सुझावों को फ़ेच करती है.

वापसी का टिकट

TextInput — यह ऑब्जेक्ट, चेनिंग के लिए.


setTitle(title)

इससे इनपुट फ़ील्ड के ऊपर दिखने वाला टाइटल सेट किया जाता है. ज़रूरी है.

पैरामीटर

नामटाइपब्यौरा
titleStringइस इनपुट के लिए टेक्स्ट लेबल.

वापसी का टिकट

TextInput — यह ऑब्जेक्ट, चेनिंग के लिए.


setValidation(validation)

यह विकल्प, इस विजेट के लिए पुष्टि करने का नियम सेट करता है.

const validation = CardService.newValidation().setCharacterLimit('10').setType(
    CardService.InputType.TEXT);

const input = CardService.newTextInput()
                  .setFieldName('text_name_xxx1')
                  .setTitle('Max 10 characters')
                  .setValidation(validation);

पैरामीटर

नामटाइपब्यौरा
validationValidationइस TextInput विजेट के लिए पुष्टि करने का नियम.

वापसी का टिकट

TextInput — यह ऑब्जेक्ट, चेनिंग के लिए.


setValue(value)

इनपुट फ़ील्ड में पहले से भरी गई वैल्यू सेट करता है.

पैरामीटर

नामटाइपब्यौरा
valueStringइनपुट में डिफ़ॉल्ट वैल्यू डाली गई है. इसे हमेशा फ़ॉर्म कॉलबैक पैरामीटर में स्ट्रिंग के तौर पर दिखाया जाता है.

वापसी का टिकट

TextInput — यह ऑब्जेक्ट, चेनिंग के लिए है.