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

পদ্ধতি

পদ্ধতি	রিটার্ন টাইপ	সংক্ষিপ্ত বিবরণ
set Field Name(fieldName)	Text Input	UI ইন্টারঅ্যাকশনের সময় উৎপন্ন ইভেন্ট অবজেক্টে এই টেক্সট ইনপুট সনাক্তকারী কী সেট করে।
set Hint(hint)	Text Input	টেক্সট ইনপুটের জন্য একটি ইঙ্গিত সেট করে।
set Host App Data Source(hostAppDataSource)	Text Input	Google Workspace অ্যাপ্লিকেশন থেকে একটি ডেটা সোর্স সেট করে।
set Multiline(multiline)	Text Input	ইনপুট টেক্সট এক লাইনে দেখানো হবে নাকি একাধিক লাইনে দেখানো হবে তা সেট করে।
set On Change Action(action)	Text Input	টেক্সট ইনপুট পরিবর্তন হলে সম্পাদিত একটি ক্রিয়া সেট করে।
set Suggestions(suggestions)	Text Input	টেক্সট ক্ষেত্রে স্বয়ংক্রিয়ভাবে সম্পন্ন করার জন্য পরামর্শ সেট করে।
set Suggestions Action(suggestionsAction)	Text Input	স্বয়ংক্রিয় সমাপ্তির জন্য ব্যবহারকারীর ইনপুটের উপর ভিত্তি করে পরামর্শ আনার জন্য কলব্যাক অ্যাকশন সেট করে।
set Title(title)	Text Input	ইনপুট ক্ষেত্রের উপরে দেখানোর জন্য শিরোনাম সেট করে।
set Validation(validation)	Text Input	এই উইজেটের জন্য বৈধতা নিয়ম সেট করে।
set Value(value)	Text Input	ইনপুট ক্ষেত্রে সেট করার জন্য পূর্বে পূরণ করা মান সেট করে।

বিস্তারিত ডকুমেন্টেশন

set Field Name(fieldName)

UI ইন্টারঅ্যাকশনের সময় তৈরি হওয়া ইভেন্ট অবজেক্টে এই টেক্সট ইনপুট সনাক্তকারী কী সেট করে। ব্যবহারকারীর কাছে দৃশ্যমান নয়। প্রয়োজনীয়, অনন্য হতে হবে।

পরামিতি

নাম	আদর্শ	বিবরণ
field Name	String	এই ইনপুটটি সনাক্ত করতে ব্যবহৃত কী।

প্রত্যাবর্তন

Text Input — চেইনিংয়ের জন্য এই অবজেক্ট।

---

set Hint(hint)

টেক্সট ইনপুটের জন্য একটি ইঙ্গিত সেট করে। ব্যবহারকারীকে কী ইনপুট করতে হবে সে সম্পর্কে অতিরিক্ত নির্দেশিকা দিতে ব্যবহৃত হয়। উদাহরণস্বরূপ, একটি ইঙ্গিত একটি ফোন নম্বর ক্ষেত্রের জন্য ফর্ম্যাটিং ("xxx-xxx-xxxx") বর্ণনা করতে পারে।

পরামিতি

নাম	আদর্শ	বিবরণ
hint	String	ইনপুট ক্ষেত্রের নিচে প্রদর্শিত টেক্সট ইঙ্গিত। এই টেক্সটটি সর্বদা দৃশ্যমান।

প্রত্যাবর্তন

Text Input — চেইনিংয়ের জন্য এই অবজেক্ট।

---

set Host App Data Source(hostAppDataSource)

Google Workspace অ্যাপ্লিকেশন থেকে একটি ডেটা সোর্স সেট করে। বর্তমানে ব্যবহারকারী এবং চ্যাট স্পেস সমর্থন করে।

শুধুমাত্র Google Workspace অ্যাড-অনগুলির জন্য Gemini Alpha প্রোগ্রামের মাধ্যমে উপলব্ধ যা 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);

পরামিতি

নাম	আদর্শ	বিবরণ
host App Data Source	Host App Data Source	তথ্য উৎস।

প্রত্যাবর্তন

Text Input — চেইনিংয়ের জন্য এই অবজেক্ট।

---

set Multiline(multiline)

ইনপুট টেক্সট এক লাইনে দেখানো হবে নাকি একাধিক লাইনে দেখানো হবে তা সেট করে।

পরামিতি

নাম	আদর্শ	বিবরণ
multiline	Boolean	বহু-লাইন সেটিং।

প্রত্যাবর্তন

Text Input — চেইনিংয়ের জন্য এই অবজেক্ট।

---

set On Change Action(action)

টেক্সট ইনপুট পরিবর্তন হলে সম্পাদিত একটি ক্রিয়া সেট করে।

পরামিতি

নাম	আদর্শ	বিবরণ
action	Action	পদক্ষেপ নিতে হবে।

প্রত্যাবর্তন

Text Input — চেইনিংয়ের জন্য এই অবজেক্ট।

---

set Suggestions(suggestions)

টেক্সট ক্ষেত্রে স্বয়ংক্রিয়ভাবে সম্পন্ন করার জন্য পরামর্শ সেট করে।

পরামিতি

নাম	আদর্শ	বিবরণ
suggestions	Suggestions	ব্যবহারের জন্য পরামর্শের সংগ্রহ।

প্রত্যাবর্তন

Text Input — চেইনিংয়ের জন্য এই অবজেক্ট।

---

set Suggestions Action(suggestionsAction)

স্বয়ংক্রিয়ভাবে সম্পন্ন করার জন্য ব্যবহারকারীর ইনপুটের উপর ভিত্তি করে পরামর্শ আনার জন্য কলব্যাক অ্যাকশন সেট করে। Action প্যারামিটারে অবশ্যই একটি কলব্যাক ফাংশন নির্দিষ্ট করতে হবে যা একটি Suggestions Response অবজেক্ট ফেরত দেয়।

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

পরামিতি

নাম	আদর্শ	বিবরণ
suggestions Action	Action	এই ইনপুটের জন্য পরামর্শ আনার ক্রিয়া।

প্রত্যাবর্তন

Text Input — চেইনিংয়ের জন্য এই অবজেক্ট।

---

set Title(title)

ইনপুট ক্ষেত্রের উপরে দেখানোর জন্য শিরোনাম সেট করে। প্রয়োজনীয়।

পরামিতি

নাম	আদর্শ	বিবরণ
title	String	এই ইনপুটের জন্য টেক্সট লেবেল।

প্রত্যাবর্তন

Text Input — চেইনিংয়ের জন্য এই অবজেক্ট।

---

set Validation(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);

পরামিতি

নাম	আদর্শ	বিবরণ
validation	Validation	এই Text Input উইজেটের জন্য বৈধতা নিয়ম।

প্রত্যাবর্তন

Text Input — চেইনিংয়ের জন্য এই অবজেক্ট।

---

set Value(value)

ইনপুট ক্ষেত্রে সেট করার জন্য পূর্বে পূরণ করা মান সেট করে।

পরামিতি

নাম	আদর্শ	বিবরণ
value	String	ইনপুটে স্থাপিত ডিফল্ট মান। এটি সর্বদা কলব্যাক প্যারামিটার আকারে একটি স্ট্রিং হিসাবে উপস্থাপিত হয়।

প্রত্যাবর্তন

Text Input — চেইনিংয়ের জন্য এই অবজেক্ট।