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

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Event Action(eventAction) Widget উইজেটে সম্পাদিত হতে পারে এমন ইভেন্ট অ্যাকশন যোগ করে।
set Field Name(fieldName) Text Input UI ইন্টারঅ্যাকশনের সময় উৎপন্ন ইভেন্ট অবজেক্টে এই টেক্সট ইনপুট সনাক্তকারী কী সেট করে।
set Hint(hint) Text Input টেক্সট ইনপুটের জন্য একটি ইঙ্গিত সেট করে।
set Host App Data Source(hostAppDataSource) Text Input Google Workspace অ্যাপ্লিকেশন থেকে একটি ডেটা সোর্স সেট করে।
set Id(id) Widget রূপান্তরিত করার জন্য উইজেট সনাক্ত করতে ব্যবহৃত অনন্য আইডি সেট করে।
set Input Mode(inputMode) Text Input এই টেক্সট ইনপুট ফিল্ডটি ভেরিয়েবল সন্নিবেশ সমর্থন করে কিনা তা সেট করে।
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 Visibility(visibility) Widget উইজেটের দৃশ্যমানতা সেট করে।

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

add Event Action(eventAction)

উইজেটে সম্পাদিত হতে পারে এমন ইভেন্ট অ্যাকশন যোগ করে।

পরামিতি

নাম আদর্শ বিবরণ
event Action Event Action Event Action যোগ করা হবে।

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

Widget — চেইন করার জন্য বস্তু।


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 অ্যাড-অনগুলির জন্য উপলব্ধ যা Google Workspace Studio প্রসারিত করে।

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 Id(id)

মিউটেশনের জন্য উইজেট শনাক্ত করতে ব্যবহৃত অনন্য আইডি সেট করে। উইজেট মিউটেশন শুধুমাত্র অ্যাড-অনগুলিতে সমর্থিত।

পরামিতি

নাম আদর্শ বিবরণ
id String উইজেটের আইডি, যার সীমা ৬৪ অক্ষর এবং `[a-zA-Z0-9-]+` ফর্ম্যাটে।

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

Widget — এই অবজেক্টটি, চেইন করার জন্য।


set Input Mode(inputMode)

এই টেক্সট ইনপুট ফিল্ডটি ভেরিয়েবল সন্নিবেশ সমর্থন করে কিনা তা সেট করে।

শুধুমাত্র Google Workspace অ্যাড-অনগুলির জন্য উপলব্ধ যা Google Workspace Studio প্রসারিত করে।

const textInput = CardService.newTextInput()
                      .setFieldName('text_input_form_input_key')
                      .setTitle('Text input title')
                      .setInputMode(CardService.TextInputMode.PLAIN_TEXT);

পরামিতি

নাম আদর্শ বিবরণ
input Mode Text Input Mode এই টেক্সট ইনপুট ফিল্ডের জন্য অনুমোদিত ইনপুটের ধরণ, ভেরিয়েবল সন্নিবেশ সমর্থন করতে RICH_TEXT ব্যবহার করুন।

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

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 — চেইনিংয়ের জন্য এই অবজেক্ট।


set Visibility(visibility)

উইজেটের দৃশ্যমানতা সেট করে। ডিফল্ট মান হল `VISIBLE`।

পরামিতি

নাম আদর্শ বিবরণ
visibility Visibility উইজেটের Visibility

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

Widget — চেইন করার জন্য বস্তু।